Available Maps

Service version: 1

Last edit: 2025.02.25

Important Note Explore ready-to-use traffic reports and data visualizations immediately by signing up for a 30-day free trial on the MOVE Portal. Once registered, you'll receive an API key to start using the Traffic Analytics APIs right away. Alternatively, you may contact our Sales team for a tailored solution.

Purpose

You can use this endpoint to verify the available map versions in all Origin/Destination (O/D) Analysis APIs. It returns a comprehensive list of map versions and types, allowing you to use them for map-matching purposes. This is an optional parameter in the Selected Link analysis creation endpoint and the Flow matrix analysis creation endpoint.

Request data

Format

Deprecated - The v1 endpoint for available maps is deprecated and will be removed in the future. TomTom recommends using the v2 version of this endpoint.

get

URL request format v1

https://{baseURL}/origindestination/{versionNumber}/maps?boundingBox={lonMin,latMin,lonMax,latMax}&key={Your_API_Key}

get

URL request format v2

https://{baseURL}/origindestination/{versionNumber}/maps/{mapType}?boundingBox={lonMin,latMin,lonMax,latMax}&key={Your_API_Key}

Example

get

URL request example v1

https://api.tomtom.com/origindestination/1/maps?boundingBox=2.2897378091610108,48.87338492728168,2.2979721908363047,48.87477506330248&key={Your_API_Key}

get

URL request example v2

https://api.tomtom.com/origindestination/1/maps/ORBIS?boundingBox=2.2897378091610108,48.87338492728168,2.2979721908363047,48.87477506330248&key={Your_API_Key}

Request parameters

The following table describes all request parameters that can be used. Required parameters must be included for the call to succeed. Optional parameters may be used.

Required parameters	Description
`baseURL` string	The base URL for calling TomTom services. Value: `api.tomtom.com`
`versionNumber` string	Version of the service to call. Value: The current value is `1`.
`key` string	Authorization key for access to the API. Value: Your valid API Key.
`mapType` string	Determines the map generation used. Possible values: `GENESIS` - A map trusted by users for years, built on proprietary and partner data. As we continue to innovate, we are excited to introduce the new `ORBIS` map type, which offers better coverage, more features, and improved freshness and quality. In the future, this option will be marked as deprecated and removed. `ORBIS` - The next generation of maps offers higher quality and accuracy when compared to the `GENESIS` map type. TomTom Orbis Maps combine open map data and TomTom proprietary data that is validated, fresh, and of the highest quality. It also integrates data sources from Overture Maps Foundation™, OpenStreetMap (OSM), partner data, and sensor-derived observations (SDOs). Read more about Orbis maps. This is the recommended map type and will be set as the default in the future.
`boundingBox` string	Coordinates defining a boundingbox in the following format: longitudeLeftDown,latitudeLeftDown,longitudeRightUpper,latitudeRightUpper. Value: 4 comma-separated float numbers.

Required POST headers

Header	Value
Content-Type	`application/json`

Response data

The response returns all possible map versions and types.

Response example

Response body - JSON
1{
2    "maps": [
3        {"type":"DSEG_NOSPLIT","version":"2022.03","releaseTimestamp":"1644521845000"},
4        {"type":"DSEG_NOSPLIT","version":"2021.12","releaseTimestamp":"1636539854000"},
5        {"type":"DSEG_NOSPLIT","version":"2021.09","releaseTimestamp":"1628847569000"},
6        ...
7    ]
8}