Class MVCustomMapTileLayer

Object
   |
   +--MVMapTileLayer
         |
         +--MVCustomMapTileLayer

class MVCustomMapTileLayer

extends MVMapTileLayer

MVCustomMapTileLayer defines a custom map tile layer, which assembles and displays map image tiles served directly by a web based map tile server, which accepts HTTP GET map tile requests. MVCustomMapTileLayer extends class MVMapTileLayer and all methods defined in MVMapTileLayer are also available in MVCustomMapTileLayer.

In order to let the javascript map client know how to assemble and display map tiles, you must provide the map tile layer definition object that defines map coordinate system, zoom levels and tiling rules. Please refer to MVMapView.addMapTileLayerDefinition for more information regarding the map tile layer definition object.

Using the map tile layer definition information, the Oracle Maps client calls tileURLProvider to get the URLs of the map tiles that it needs to display to map. tileURLProvider is a user defined javascript function that returns the URL of the map tile image specified by the tile bounding box and zoom level. It accepts five parameters provided by the javascript map client:

• X coordinate of the left-lower corner of the tile in map coordinate system
• Y coordinate of the left-lower corner of the tile in map coordinate system
• Tile width in map coordinate system
• Tile height in map coordinate system
• Map zoom level

Constructor Detail

MVCustomMapTileLayer

MVCustomMapTileLayer(<Object> layerDefinition, <Function> tileURLProvider)

Parameters:
layerDefinition - layerDefinition is an object that specifies the map tile layer definition.
tileURLProvider - tileURLProvider is a function that returns the URL of the map tile image specified by tile coordinates and zoom level.

Returns:
The newly created MVCustomMapTileLayer object.

baseClass

object baseClass(<String> mapTileLayerName, <String> tileServerURL)

Parameters:
mapTileLayerName - mapTileLayerName is a string that identifies the map tile layer. It is defined in the form of data-source-name.map-tile-layer-name, where map-tile-layer-name specifies the name of the map tile layer that has been pre-defined on the server side and data-source-name specifies the name of the MapViewer data source in which the map tile layer is defined.
tileServerURL - tileServerURL is a string that specifies the URL of the map tile server, which should be in the form http://host:port/mapviewer/mcserver. This is an optional parameter. When omitted, the map tile server URL is derived from the MapViewer base URL specified when creating the MVMapView object.

Returns:
The newly created MVMapTileLayer object.