Defining the Built-in Map Tile Layers on the Client Side Defining the Built-In Map Tile Layers on the Server Side

8-28 Oracle Fusion Middleware Users Guide for Oracle MapViewer

8.6 Built-in Map Tile Layers Google Maps and Bing Maps

Applications can display Google Maps tiles or Microsoft Bing Maps tiles as a built-in map tile layer. Internally, the Oracle Maps client uses the official Google Maps or Bing Maps API to display the map that is directly served by the Google Maps or Microsoft Bing Maps server. ■ To use the Google Maps tiles, you must obtain a Google Maps API key for your application. Your usage of the Google Maps tiles must meet the terms of service specified by Google see http:code.google.comapismapsterms.html . ■ To use the Bing Maps tiles, you must get a Bing Maps account. Your usage must meet the licensing requirement specified by Microsoft see http:www.microsoft.commapsproductlicensing.aspx . If you need to overlay your own spatial data on top of the Google Maps or Microsoft Bing Maps tile layer, see also Section 8.7, Transforming Data to a Spherical Mercator Coordinate System . The following sections describe the two options for using built-in map tile layers: ■ Section 8.6.1, Defining the Built-in Map Tile Layers on the Client Side ■ Section 8.6.2, Defining the Built-In Map Tile Layers on the Server Side

8.6.1 Defining the Built-in Map Tile Layers on the Client Side

To define a built-in map tile layer on the client side, you need to add a script tag to your application web page to load the Google or Bing Maps JavaScript library, create a MVGoogleTileLayer or MVBingTileLayer object, and add it to the MVMapView object. For example, to use Google tiles, add the following script tag to your application Web page: script src=http:maps.google.commaps?file=apiv=2key=[your_api_key] type=textjavascriptscript Also, add the Google tile layer to your map: mapview = new MVMapViewdocument.getElementByIdmap, baseURL; tileLayer = new MVGoogleTileLayer ; mapview.addMapTileLayertileLayer; In your application, you can invoke the method MVGoogleTileLayer.setMapType or MVBingTileLayer.setMapType to set the map type to be one of the types supported by the map providers, such as road, satellite, or hybrid. For usage examples and more information, see the JavaScript API documentation for MVGoogleTileLayer and MVBingTileLayer, and the tutorial demos Built-in Google Maps Tile Layer and Built-in Bing Maps Tile Layer.

8.6.2 Defining the Built-In Map Tile Layers on the Server Side

You can define a built=-in map tile layer on the server side and use it as a regular MapViewer tile layer on the client side. To define a built-in map tile layer on the server side, follow these steps: 1. Log into the MapViewer Administration Page explained in Section 1.5.1 .

2. Select the Manage Map Tile Layers tab and click Create.

Oracle Maps 8-29

3. When you are asked to select the type of map source, choose Google Maps or

Bing Maps and click Continue. 4. Select the data source where the tile layer is to be defined. 5. Set the license key that you have obtained from the map provider.

6. Click Submit to create the tile layer.

After you have created the built-in map tile layer on the server side, you can use it like any other tile layer served by MapViewer. You do not need to add any script tag to load the external JavaScript library. The following example shows a Bing Maps tile layer defined on the server side: mapview = new MVMapViewdocument.getElementByIdmap, baseURL; The Bing tile layer is defined in data source “mvdemo”. tileLayer = new MVMapTileLayermvdemo.BING_MAP ; mapview.addMapTileLayertileLayer; In your application, you can invoke the method MVMapTileLayer.setMapType to set the map type to be one of the types supported by the map providers, such as road, satellite, or hybrid.

8.7 Transforming Data to a Spherical Mercator Coordinate System