Constructing a Request
A typical request to the HERE Map Tile v2 includes the basic elements shown in the following table and may contain resource-specific parameters or data.
Element | Value/Example | Description |
---|---|---|
Base URL | Aerial Tiles Base Map Tiles Traffic Tiles | Production environment See also Load Balancing and URLs |
Legacy Base URL | Traffic Tiles Traffic Tiles Traffic Tiles | Production environment when you use an app_id/app_code pair. For more information, see Load Balancing and URLs. For the available authentication options, see the Identity & Access Management Developer Guide. |
Path | /maptile/2.1/ | |
Resource (tile type) | | GET only. For a more detailed parameter list for each resource, see API Reference. |
Map version | newest (example) | Specifies the map version, either newest or with a hash value. See also Map Versions. |
Scheme | normal.day (example) | Specifies the view scheme. A complete list of the supported schemes may be obtained by using the Info resource. Note: Be aware that invalid combinations of schemes and tiles are rejected. For all For the Traffic Tiles and Map Tiles support the other traffic related schemes ( |
Zoom | 13 (example) | Zoom level of the map image. Minimum and maximum zoom levels are specified in the Info resource. |
Column | 4400 (example) | The number of tiles per column is a function of the zoom: number of columns = 2zoom |
Row | 2686 (example) | The number of tiles per row is a function of the |
Size | 256 (example) | Returned image size. The following sizes ([width, height]) are supported:
Note: Raster coverage tiles ( |
Format | png8 (example) | Returned image format. The following image formats are supported:
Please note that JPG is recommended for |
API Key | ?apiKey={YOUR_API_KEY} | Substitute your own unique apiKey . For more information on authentication, see the Identity & Access Management Developer Guide. |
Application Code - Legacy | &app_code={YOUR_APP_CODE} | Substitute your own unique app_code . For more information on authentication, see the Identity & Access Management Developer Guide. |
Application ID - Legacy | &app_id={YOUR_APP_ID} | Substitute your own unique app_id . For more information on authentication, see the Identity & Access Management Developer Guide. |
Resource Specific Parameters | &{parameter=value} | Optional Query Parameter. Refer to the API definition for values. |
Notes:
[1] | Use the right base URL depending on what kind of tiles you want to get. Keep in mind that for some schemes you should use different base URLs. For more information, see the API reference. |
[2] | Use the right base URL depending on which environment you want to get information from. |
[3] | Use the traffic tile base URL for this request. |
{Base URL}{Path}{resource (tile type)}/{map id}/{scheme}/{zoom}/{column}/{row}/{size}/{format}
?apiKey={YOUR_API_KEY}
&{param}={value}
POST
requests are not allowed.