Available Maps

Service version: 1
Last edit: 2022.08.22

Purpose

To check what map versions are available in all OD Analysis APIs you can simply use this endpoint. This returns all possible map versions and types, which you can use for the map-matching purpose as an optional parameter of the analysis creation endpoint.

Request data

Format

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

Example

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

Request parameters

The following table describes all of the parameters that can be used in a request. Required parameters must be used or the call will fail. Optional parameters may be used.

Required parametersDescription
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.
boundingBox
string
Coordinates defining a boundingbox in the following format: longitudeLeftDown,latitudeLeftDown,longitudeRightUpper,latitudeRightUpper.
Value: 4 comma-separated float numbers.

Required POST headers

HeaderValue
Content-Typeapplication/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}