Retrieve the rendered map tile in requested format

get

https://maps.hereapi.com/v3/{resource}/{projection}/{zoom}/{column}/{row}/{format}

Retrieve the rendered map tile in requested format. It is possible to select among different parameters to modify the output, like a different style, languages, label size, and so on.

Path Params

resource

string

required

Specifies the type of tile. Supported values are listed in 'info' resource.

projection

string

required

Specifies the tile projection. Supported values are listed in 'info' resource.

mc - Mercator Projection

zoom

integer

required

Zoom level of the map image. Minimum and maximum zoom level is specified in the 'info' resource.

column

integer

required

0 to 1048576

col – can be any number between 0 and number of columns - 1, both inclusive.

The number of tiles per column is a function of the zoom: number of columns = 2^zoom.

[0,0] (col,row) corresponds to top left of a typical western map.

row

integer

required

0 to 1048576

row – can be any number between 0 and number of rows - 1, both inclusive.

The number of tiles per row is a function of the zoom: number of rows = 2^zoom.

[0,0] (col,row) corresponds to top left of a typical western map.

format

string

required

Returned image format. Supported values are listed in 'info' resource.

Query Params

string

^([a-z]{2,3}[0-9]+)+$

deprecated

Specifies the map version to be used. The map version can be retrieved by querying /info.

lang

string

^[a-z]{2}(-[a-zA-Z]{1,4})?$

The BCP47 language code (https://www.rfc-editor.org/rfc/bcp/bcp47.txt)
limited to ISO 639-1 two-letter language code and, optionally, ISO 15924 four-letter script code.
It is used for requesting a map tile rendered in a specific language.
Supported values are listed in 'languages' resource.

Default behavior when no parameter is given is:

Each country will be shown in the default language of the country.
The following labels will be shown in the default language: continent, ocean, sea, bay.

lang2

string

^[a-z]{2}(-[a-zA-Z]{1,4})?$

This parameter can be used to provide a second language for use in dual labeling,
it follows the same behavior as the parameter 'lang'.

pview

string

^[A-Z]{2,3}$

Use this parameter to render the map with boundaries based on international or local country views.
In general, the international view should be used unless the map is being used within one of those countries
for which a local view is available.
If the parameter is specified and the view is supported, boundaries of the selected country view are being shown.
Not specifying the parameter results in a default view of boundaries.

The values follow ISO 3166-1 alpha-2 country codes schema.

Note: You should check the /politicalViews path for further information about how to get the most up to date list of geopolitical views available from the service.
Note: If this parameter is missing, the international view is returned.

style

string

If present, selects the style to use to render the tile. The possible values are listed in 'info' resource.
Note: When not provided, the default style is "explore.day".

ppi

integer

enum

Defaults to 100

Specifies the relative size of labels and icons. Valid values are:

100 – small
200 – medium
400 – large
For more information, see Specify the label and icon size.

Allowed:

features

string

^([a-zA-Z0-9\-_]+:[a-zA-Z0-9\-_]+)(,([a-zA-Z0-9\-_]+:[a-zA-Z0-9\-_]+))*$

If present, allows to query tiles by specific features.
The features are independent, and the result of the example is that the tile is rendered with feature_a feature in mode_a mode AND feature_b feature in mode_b mode.
The possible values for features and modes are also listed in the features resource.

congestion_zones - Display of congestion zones. The available modes include:
- all
- disabled
environmental_zones - Display of environmental zones. The available modes include:
- all
- disabled
pois - Display of points of interest. The available modes include:
- all
- disabled
vehicle_restrictions - Display of road signs specific to trucks or other special vehicles. The available modes include:
- active_and_inactive - Show all restrictions (both active and inactive)
- permanent_only - Show only permanent restrictions
- active_and_inactive_differentiated - Show all restrictions differentiated by active/inactive status, using the vehicle_restrictions parameter for time-based filtering.
- active_only - Show only active restrictions, using the vehicle_restrictions parameter for time-based filtering.
- disabled - Do not display vehicle restrictions
public_transit - Display of public transit system. The available modes include:
- asia_selected_systems
- all_systems
- disabled
truck_preferred_roads - Display of truck preferred roads. The available modes include:
- all
- disabled

size

integer

Defaults to 256

Image size in pixels. Supported values are listed in 'info' resource.

scale

integer

enum

Defaults to 1

Controls the scaling of the rendered tiles for high-resolution displays. A value of 2 doubles the size of the rendered tiles for sharper images.

Allowed:

startTime

string

^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}$

Start time for vehicle restrictions time window.
Must only be used with the vehicle_restrictions feature using modes "active_and_inactive_differentiated" or "active_only".
Format: Local RFC 3339 datetime as YYYY-MM-DDTHH:mm without timezone (e.g., 2025-12-03T08:00)

endTime

string

^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}$

End time for vehicle restrictions time window.
Must only be used with the vehicle_restrictions feature using modes "active_and_inactive_differentiated" or "active_only".
Format: Local RFC 3339 datetime as YYYY-MM-DDTHH:mm without timezone (e.g., 2025-12-03T18:00)

Headers

If-None-Match

string

Specifies an optional entity tag of the resource cached in the client.
See 304 response of getTile operation for more details.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200OK - Requested resource is returned

304The resource cached in the client (identified by the If-None-Match header) has not changed.

400API response in case of errors due to bad request.

401Access token is missing or invalid.

403Access token does not authorize access.

404API response indicates that the resource was not found.

500API response indicates a server malfunction and an unexpected error.

503API response indicates indicates that the service is temporarily unavailable due to system overload or maintenance. Try later for the same resource and the request might succeed.

504API response indicates indicates that the server, while acting as a gateway or proxy, did not get a response in time from the upstream server that it needed in order to complete the request. Try later for the same resource and the request might succeed.

defaultAPI response in case of errors.