Available Maps
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
https://{baseURL}/origindestination/{versionNumber}/maps?boundingBox={lonMin,latMin,lonMax,latMax}&key={Your_API_Key}
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 parameters | Description |
|---|---|
| The base URL for calling TomTom services. Value: |
| Version of the service to call. Value: The current value is |
| Authorization key for access to the API. Value: Your valid API Key. |
| Coordinates defining a boundingbox in the following format: longitudeLeftDown,latitudeLeftDown,longitudeRightUpper,latitudeRightUpper. Value: 4 comma-separated float numbers. |
Required POST headers
Header | Value |
|---|---|
|
Response data
The response returns all possible map versions and types.
Response example
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}