Maps API for JavaScript Developer's Guide

H.service.MapTileService

Class Summary

Extends: H.util.EventTarget

Implements: H.service.IConfigurable

This class encapsulates a map tile end point of the HERE Map Tile API.

[ For full details, see the Class Details ]

Method Summary

Table 1. Methods
Methods

getType () : {string}

This method retrieves the map tile type provided by this service.

getVersion () : {string}

This method retrieves a hash representing the newest version of the given map tile service.

getInfo () : {(H.service.MapTileService.Info | undefined)}

This method retrieves meta information for the map tile service. It returns an object if the data associated with the given map tile service has been fetched.

createTileProvider (tileType, scheme, tileSize, format, opt_additionalParameters, opt_options) : {H.map.provider.ImageTileProvider}

This method creates a tile provider which uses the specified map tiles. This provider can be used as a data source for an ImageTileLayer.

createTileLayer (tileType, scheme, tileSize, format, opt_additionalParameters, opt_opacity, opt_dark, opt_options) : {H.map.layer.TileLayer}

This method creates a tile layer. This layer can be used as a layer on the map data model.

configure (appId, appCode, useHTTPS, useCIT, opt_baseUrl) : {H.service.IConfigurable}

This methods receive configuration parameters from the platform, that can be used by the object implementing the interface.

Events Summary

Table 2. Events
Events

infoupdate : {H.util.Event}

This event is fired when the info resource for the given service has been successfully retrieved and processed.

versionupdate : {H.util.Event}

This event is fired when the version hash for the given service has been successfully updated.

copyrightupdate : {H.util.Event}

This event is fired when the copyright information for the given service has been successfully retrieved.

Class Description

This class encapsulates a map tile end point of the HERE Map Tile API.

An instance of this class can be retrieved by calling the factory method on a platform instance. H.service.Platform#getMapTileService.

Example

// Assumption: the platform is instantiated
var maptiler = platform.getMapTileService({type: 'aerial'}),
  tileLayer = maptiler.createTileLayer('maptile', 'hybrid.day', 256, 'jpg');
map.setBaseLayer(tileLayer);

Constructor Details

H.service.MapTileService(opt_options)

Parameters:
 
opt_options:
{H.service.MapTileService.Options=} [optional]
 
An object containing the configuration options for MapTileService

Method Details

getType () : {string}

This method retrieves the map tile type provided by this service.

Returns:
 
{string}
A value indicating the map tile type

getVersion () : {string}

This method retrieves a hash representing the newest version of the given map tile service.

Returns:
 
{string}
An object containing meta information for this map tile service

getInfo () : {(H.service.MapTileService.Info | undefined)}

This method retrieves meta information for the map tile service. It returns an object if the data associated with the given map tile service has been fetched.

Returns:
 
{(H.service.MapTileService.Info | undefined)}
An object containing meta information for the given map tile service, if available, otherwise undefined

createTileProvider (tileType, scheme, tileSize, format, opt_additionalParameters, opt_options) : {H.map.provider.ImageTileProvider}

This method creates a tile provider which uses the specified map tiles. This provider can be used as a data source for an ImageTileLayer.

Parameters:
 
tileType:
{string}
 
An identifier of the tile type
scheme:
{string}
 
An identifier of the tile scheme
tileSize:
{number}
 
A value indicating the tile size
format:
{string}
 
An identifier of the tile image format
opt_additionalParameters:
{H.service.ServiceParameters=} [optional]
 
a hash of additional parameters to be sent to the HERE Map Tile API with each tile request.
opt_options:
{H.service.TileProviderOptions=} [optional]
 
An object containing a set of options for the tile provider object
Returns:
 
{H.map.provider.ImageTileProvider}
An object representing the image tile provider

createTileLayer (tileType, scheme, tileSize, format, opt_additionalParameters, opt_opacity, opt_dark, opt_options) : {H.map.layer.TileLayer}

This method creates a tile layer. This layer can be used as a layer on the map data model.

Parameters:
 
tileType:
{string}
 
An identifier of the tile type
scheme:
{string}
 
An identifier of the tile scheme
tileSize:
{number}
 
A value indicating the tile size
format:
{string}
 
An identifier of the tile image format
opt_additionalParameters:
{H.service.ServiceParameters=} [optional]
 
a hash of additional parameters to be sent to the HERE Map Tile API with each tile request.
opt_opacity:
{number=} [optional]
 
A value indicating the opacity of the tile layer
opt_dark:
{boolean=} [optional]
 
A Boolean value indicating whether the content of this layer is mainly dark, the default is false. See also H.Map.Options#autoColor
opt_options:
{H.service.TileProviderOptions=} [optional]
 
An object specifying an additional set of options for the provider
Returns:
 
{H.map.layer.TileLayer}
An object representing the newly create tile layer

configure (appId, appCode, useHTTPS, useCIT, opt_baseUrl) : {H.service.IConfigurable}

This methods receive configuration parameters from the platform, that can be used by the object implementing the interface.

Parameters:
 
appId:
{string}
 
The application ID to identify the client against the platform (mandatory)
appCode:
{string}
 
The application code to identify the client against the platform (mandatory)
useHTTPS:
{boolean}
 
A value indicating whether secure communication should be used (true), the default is false
useCIT:
{boolean}
 
A value indicating whether Customer Integration Testing should be used (true), the default is false
opt_baseUrl:
{H.service.Url=} [optional]
 
The base URL of the platform, the default is http://api.here.com. Note that if the useHTTPS flag is provided, the URL scheme specified in the opt_baseUrl is overridden to use HTTPS.
Returns:
 
{H.service.IConfigurable}
An instance of IConfigurable reflecting the new configuration

Event Details

infoupdate: {H.util.Event}

This event is fired when the info resource for the given service has been successfully retrieved and processed.

versionupdate: {H.util.Event}

This event is fired when the version hash for the given service has been successfully updated.

copyrightupdate: {H.util.Event}

This event is fired when the copyright information for the given service has been successfully retrieved.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.