Available Maps

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 map matching purpose in optional parameter of analysis creation endpoint.

Request data

Format

POST
URL request example
https://api.tomtom.com/origindestination/1/maps?boundingBox={lonMin,latMin,lonMax,latMax}&key={apikey}

Example

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

Required headers

HeaderValue

Content-Type

application/json

Request Parameters

The table below 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.

ParameterDescriptionRequired?Type / ValuesDefault Value
apiKeyAuthorization key for access to the API.YesAPI Key
boundingBoxCoordinates defining boundingbox in following format: longitudeLeftDown,latitudeLeftDown,longitudeRightUpper,latitudeRightUpperYes4 float numbers comma separated

Response example

GET
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}