HERE Map Tile v2 Developer's Guide

Version

This version resource handles requests for software version details.

The following URL shows the format of a version request and the table below explains each parameter.

Note: These examples use a HERE API Key to authenticate your request. For the available authentication options, see the Identity & Access Management Developer Guide.
https://{1-4}.base.maps.ls.hereapi.com/maptile/2.1/version
?apiKey={YOUR_API_KEY}
&{param}={value}
Note: Metadata requests retrieve information specific to the base URLs they target. This information cannot be used in subsequent requests that use other base URLs. For example, to obtain a base map version, use metadata from the response to a request addressed to the Base Map Tiles base URL, but for a version of an aerial map, use metadata from the response to a request addressed to the Aerial Tiles base URL.

Mandatory Query Parameters

The following table lists the mandatory parameters that need to be specified with every request. Not specifying these parameters will make the system reject the request.

Table 1. Mandatory Query Parameters
Parameter Type Description
app_id (deprecated)

xs:string

A 20-byte Base64 URL-safe encoded string used in one of the available authentication options for the HERE Map Tile v2.

If you use the app ID/app code option, you need to include an app_id and app_code with every request. For more information on authentication, see the Identity & Access Management Developer Guide.

app_code (deprecated)

xs:string

A 20-byte Base64 URL-safe encoded string used for the authentication of the client application.

If you use the app ID/app code option, you need to include an app_id and app_code with every request. For more information on authentication, see the Identity & Access Management Developer Guide.

apiKey

xs:string

A 43-byte Base64 URL-safe encoded string used for the authentication of the client application. As a logged in user, you can generate it at https://developer.here.com/projects. API Keys never expire but you can invalidate your API Keys at any time. You cannot have more than two API Keys for one app at the same time.

You must include an apiKey with every request. For more information on authentication, see the Identity & Access Management Developer Guide.

Example

The following example shows a request addressed to the version resource.

https://{1-4}.base.maps.ls.hereapi.com
/maptile/2.1/version
?apiKey={YOUR_API_KEY}

The response contains information as shown in this example.

MRS: 2.1.36.0
MOS: 2.0.1.2676023561
Map: 8.30.53.109

Note that the first element is the version of the HERE Map Tile v2, while the second is the version of the underlying map rendering system. The third element shows the version of the map currently loaded. Be aware that this is just an example and the version varies from release to release.