Map Styles
Public Preview Notice
This API is in Public Preview. Go to the Public Preview - what is it? page to see what this means.
We welcome your contribution to the development of this version. Please share your observations and suggestions on our forum or send an email to our software engineers.
We appreciate your feedback, and we will keep you posted on how it's used.
Purpose
The Maps API Resource service delivers resources required to display vector maps. The service consists of the:
- Metadata method: This retrieves a list of resources of a selected type.
- Resource method: This retrieves a selected resource.
- Merged style method: This retrieves a merged style depending on the passed params.
- Merged sprite method: This retrieves a merged sprite depending on the passed params.
You can find the structure of the map style in the MapLibre Style Specification documentation.
Request data
Metadata method
HTTPS method: GET
Please see the following Request parameters section with the required and optional parameters tables for these values. The generic URL format is as follows.
URL format
https://{baseURL}/map/{versionNumber}/{resourceType}/{resourceVersion}/{resourceVariant}/metadata.{format}?key={Your_API_Key}
Examples
1https://api.tomtom.com/map/1/style/metadata.json?key={Your_API_Key}23https://api.tomtom.com/map/1/style/22.2.1-9/2/metadata.json?key={Your_API_Key}45https://api.tomtom.com/map/1/style/22.*/2/metadata.json?key={Your_API_Key}67https://api.tomtom.com/map/1/sprite/22.2.1-9/2/metadata.json?key={Your_API_Key}89https://api.tomtom.com/map/1/glyph/22.2.1-9/metadata.json?key={Your_API_Key}
curl command format
curl 'https://api.tomtom.com/map/1/style/22.2.1-9/2/metadata.json?key={Your_API_Key}'
Request parameters (Metadata method)
The following table describes the parameters that can be used in a request.
- Required parameters must be used or the call will fail.
- Parameters and values are case-sensitive.
- Optional parameters may be used.
Required parameters | Description |
---|---|
string | Base URL for calling TomTom services. Value: |
string | The version of the service to call. Value: The current version is |
string | The type of the requested resource. Values:
|
string | The requested response format. Values:
|
string | The authorization key for access to the API. Value: Your valid |
Optional parameters | Description |
---|---|
string | Version of the requested resource. If the version string contains a wildcard, the latest matching version of the resource will be provided. Values:
|
string | Variant of the requested resource. Can only be used when
Value: The variant name, e.g., |
Resource method
HTTPS method: GET
Please see the following Request parameters section with the required and optional parameters tables for these values. The generic URL format is as follows.
URL format
https://{baseURL}/map/{versionNumber}/{resourceType}/{resourceVersion}/{resourceVariant}/{resourceName}?key={Your_API_Key}
Examples
1https://api.tomtom.com/map/1/style/22.*/2/basic_street-light.json?key={Your_API_Key}23https://api.tomtom.com/map/1/style/22.2.1-9/2/basic_street-light.json?key={Your_API_Key}45https://api.tomtom.com/map/1/sprite/22.2.1-9/2/basic_street-light/sprite.png?key={Your_API_Key}
curl command format
curl 'https://api.tomtom.com/map/1/style/22.2.1-9/2/basic_street-light.json?key={Your_API_Key}'
Request parameters (Resource method)
The following table describes the parameters that can be used in a request.
- Required parameters must be used or the call will fail.
- Parameters and values are case-sensitive.
- Optional parameters may be used.
Required parameters | Description |
---|---|
string | Base URL for calling TomTom services Value: |
string | The version of the service to call. Value: The current version is |
string | The type of the requested resource. Values:
|
string | The version of the requested resource. If the version string contains a wildcard, the latest matching version of the resource will be provided. Available versions can be listed using the Metadata method. Values:
|
string | The requested resource name (with an extension if applicable). Available resources can be listed using the Metadata method. Value: A resource name. |
string | Authorization key for access to the API. Value: Your valid |
Optional parameters | Description |
---|---|
string | The variant of the requested resource. Available variants can be listed using the Metadata method. Value: For example, |
Merged style method
HTTPS method: GET
- Constants and parameters enclosed in curly brackets { } must be replaced with their values.
- Please see the following Request parameters section with the required and optional parameters tables for their values. The generic request format is as follows.
URL format
https://{baseURL}/style/{versionNumber}/style/{resourceVersion}?key={Your_API_Key}&map={map_style}&traffic_incidents={traffic_incident_style}&traffic_flow={traffic_flow_style}&poi={poi_style}&restrictions={restrictions_style}&hillshade={hillshade_style}
Examples
1https://api.tomtom.com/style/1/style/22.2.1-9?key={Your_API_Key}&map=2/basic_street-light&traffic_incidents=2/incidents_light&traffic_flow=2/flow_relative-light&poi=2/poi_light23https://api.tomtom.com/style/1/style/22.2.1-9?key={Your_API_Key}&map=2/basic_street-light&traffic_incidents=2/incidents_light45https://api.tomtom.com/style/1/style/22.2.1-9?key={Your_API_Key}&traffic_incidents=2/incidents_light&traffic_flow=2/flow_relative-light67https://api.tomtom.com/style/1/style/24.2.0-3?key={Your_API_Key}&map=2/basic_street-light&hillshade=2/hillshade_light
curl command format
curl 'https://api.tomtom.com/style/1/style/22.2.1-9?key={Your_API_Key}&traffic_incidents=2/incidents_light&traffic_flow=2/flow_relative-light'
Request parameters (Merged style method)
The following table describes the parameters that can be used in a request.
- Required parameters must be used or the call will fail.
- Parameters and values are case-sensitive.
- At least one optional parameter;
map
,traffic_incidents
,traffic_flow
,poi
,restrictions
, orhillshade
must be used or the call will fail.
Required parameters | Description |
---|---|
string | Base URL for calling TomTom services. Value: |
string | The version of the service to call. Value: The current version is |
string | Version of the requested resource. Must be newer than or equal to 22.2.1-9. If the version string contains a wildcard, the latest matching version of the resource will be provided. Values:
|
string | The authorization key for access to the API. Value: Your valid |
Optional parameters | Description |
---|---|
string | Map style name (including variant if applicable) to be used for the merged style. Values: See Available map styles. |
string | Traffic incidents style name (including variant if applicable) to be used for the merged style. Values: See Available incidents styles. |
string | Traffic flow style name (including variant if applicable) to be used for the merged style. Values: See Available flow styles. |
string | POI style name (including variant if applicable) to be used for the merged style. Values: See Available POI styles. |
string | Restrictions style name (including a variant if applicable) to be used for the merged style. Values: See Available restrictions styles. |
string | Hillshade style name (including variant if applicable) to be used for the merged style. Values: See Available Hillshade styles. |
Available Map styles
Name (and variant if applicable) | Preview | Available since | Available until |
---|---|---|---|
2/basic_street-light | ![]() | 22.2.1-9 | - |
2/basic_street-dark | ![]() | 22.2.1-9 | - |
2/basic_street-light-driving | ![]() | 22.2.1-9 | - |
2/basic_street-dark-driving | ![]() | 22.2.1-9 | - |
2/basic_mono-light | ![]() | 22.2.1-16 | - |
2/basic_mono-dark | ![]() | 24.1.0-15 | - |
2/basic_street-satellite | ![]() | 22.2.1-9 | - |
2/hybrid_street-light | ![]() | 22.2.1-9 | - |
2/hybrid_street-dark | ![]() | 22.2.1-9 | - |
2/hybrid_street-light-driving | ![]() | 22.2.1-9 | - |
2/hybrid_street-dark-driving | ![]() | 22.2.1-9 | - |
2/hybrid_street-satellite | ![]() | 22.2.1-9 | - |
2/labels_street-light | ![]() | 22.2.1-9 | - |
2/labels_street-dark | ![]() | 22.2.1-9 | - |
2/labels_street-light-driving | ![]() | 22.2.1-9 | - |
2/labels_street-dark-driving | ![]() | 22.2.1-9 | - |
2/labels_street-satellite | ![]() | 22.2.1-9 | - |
basic_main | ![]() | 20.3.2-3 | - |
basic_night | ![]() | 20.3.2-3 | - |
basic_main-lite | ![]() | 20.3.2-3 | - |
basic_night-lite | ![]() | 20.3.2-3 | - |
hybrid_main | ![]() | 20.3.2-3 | - |
hybrid_night | ![]() | 20.3.2-3 | - |
hybrid_main-lite | ![]() | 20.3.2-3 | - |
hybrid_night-lite | ![]() | 20.3.2-3 | - |
labels_main | ![]() | 20.3.2-3 | - |
labels_night | ![]() | 20.3.2-3 | - |
labels_main-lite | ![]() | 20.3.2-3 | - |
labels_night-lite | ![]() | 20.3.2-3 | - |
Available Incidents styles
Name (and variant if applicable) | Preview | Available since | Available until |
---|---|---|---|
2/incidents_light | ![]() | 22.2.1-9 | - |
2/incidents_dark | ![]() | 22.2.1-9 | - |
incidents_day | ![]() | 20.3.2-3 | - |
incidents_dark | ![]() | 20.3.2-3 | - |
incidents_night | ![]() | 20.3.2-3 | - |
incidents_s0 | ![]() | 20.3.2-3 | - |
incidents_s0-dark | ![]() | 20.3.2-3 | - |
incidents_s1 | ![]() | 20.3.2-3 | - |
incidents_s2 | ![]() | 20.3.2-3 | - |
incidents_s3 | ![]() | 20.3.2-3 | - |
Available Flow styles
Name (and variant if applicable) | Preview | Available since | Available until |
---|---|---|---|
2/flow_relative-light | ![]() | 22.2.1-9 | - |
2/flow_relative-dark | ![]() | 22.2.1-9 | - |
flow_absolute | ![]() | 20.3.2-3 | - |
flow_reduced-sensitivity | ![]() | 20.3.2-3 | - |
flow_relative-delay | ![]() | 20.3.2-3 | - |
flow_relative0 | ![]() | 20.3.2-3 | - |
flow_relative0-dark | ![]() | 20.3.2-3 | - |
Available POI styles
Name (and variant if applicable) | Preview | Available since | Available until |
---|---|---|---|
2/poi_light | ![]() | 22.2.1-9 | - |
2/poi_dark | ![]() | 22.2.1-9 | - |
2/poi_satellite | ![]() | 22.2.1-9 | - |
2/poi_dynamic-light | ![]() | 22.2.1-9 | - |
2/poi_dynamic-dark | ![]() | 22.2.1-9 | - |
2/poi_dynamic-light | ![]() | 22.2.1-9 | - |
2/poi_dynamic-mono-dark | ![]() | 24.1.0-15 | - |
2/poi_dynamic-mono-light | ![]() | 22.2.1-16 | - |
2/poi_mono-dark | ![]() | 24.1.0-15 | - |
2/poi_mono-light | ![]() | 22.2.1-16 | - |
poi_main | ![]() | 20.3.4-6 | - |
poi_dynamic | ![]() | 20.4.5-8 | - |
Available Restrictions styles
Name (and variant if applicable) | Preview | Available since | Available until |
---|---|---|---|
2/restrictions_light | ![]() | 24.1.0-16 | - |
2/restrictions_dark | ![]() | 24.1.0-16 | - |
Available Hillshade styles
Name (and variant if applicable) | Preview | Available since | Available until |
---|---|---|---|
2/hillshade_dark | ![]() | 24.2.2-8 | - |
2/hillshade_light | ![]() | 24.2.2-8 | - |
2/hillshade_mono-dark | ![]() | 24.2.2-8 | - |
2/hillshade_mono-light | ![]() | 24.2.2-8 | - |
2/hillshade_satellite | ![]() | 24.2.2-8 | - |
Merged sprite method
HTTPS method: GET
Please see the following Request parameters section with the required and optional parameters tables for these values. The generic URL format is as follows.
URL format
https://{baseURL}/style/{versionNumber}/sprite/{resourceVersion}/{type}?key={Your_API_Key}&map={map_style}&traffic_incidents={traffic_incident_style}&traffic_flow={traffic_flow_style}&poi={poi_style}&restrictions={restrictions_style}&hillshade={hillshade_style}
Examples
1https://api.tomtom.com/style/1/sprite/22.2.1-9/sprite.png?key={Your_API_Key}&map=2/basic_street-light&traffic_incidents=2/incidents_light&traffic_flow=2/flow_relative-light&poi=2/poi_light23https://api.tomtom.com/style/1/sprite/22.2.1-9/sprite@2x.json?key={Your_API_Key}&map=2/basic_street-light&traffic_incidents=2/incidents_light45https://api.tomtom.com/style/1/sprite/22.2.1-9/sprite@2x.png?key={Your_API_Key}&traffic_incidents=2/incidents_light&traffic_flow=2/flow_relative-light67https://api.tomtom.com/style/1/sprite/24.2.0-3/sprite@2x.png?key={Your_API_Key}&map=2/basic_street-light&hillshade=2/hillshade_dem
curl command format
curl 'https://api.tomtom.com/style/1/sprite/22.2.1-9/sprite.json?key={Your_API_Key}&traffic_incidents=2/incidents_light&traffic_flow=2/flow_relative-light'
Request parameters (Merged sprite method)
The following table describes the parameters that can be used in a request.
- Required parameters must be used or the call will fail.
- Parameters and values are case-sensitive.
- At least one optional parameter;
map
,traffic_incidents
,traffic_flow
orpoi
must be used or the call will fail.
Required parameters | Description |
---|---|
string | Base URL for calling TomTom services. Value: |
string | The version of the service to call. Value: The current version is |
string | Version of the requested resource. Must be newer than or equal to 22.2.1-9. If the version string contains a wildcard, the latest matching version of the resource will be provided. Values:
|
string | The requested type of data. Values:
|
string | The authorization key for access to the API. Value: Your valid |
Optional parameters | Description |
---|---|
string | Map style name to be used for the merged sprite. Values: See available map styles. |
string | Traffic incidents style name to be used for the merged sprite. Values: See available incidents styles. |
string | Traffic flow style name to be used for the merged sprite. Values: See available flow styles. |
string | POI style name to be used for the merged sprite. Values: See available poi styles. |
string | Restrictions style name to be used for the merged sprite. Values: See available restrictions styles. |
string | Hillshade style name (including variant if applicable) to be used for the merged style. Values: See Available Hillshade styles. |