Sorry, you need to enable JavaScript to visit this website.

Available Maps

To check what map versions are available in all Traffic Stats APIs you can simply use this endpoint. Map version should be selected based on a Date Range provided in create report POST request.

When asking for data in the last two years (this is a moving time window), a rich selection of maps is available. When requesting data older than 2 years, only 2016.12 and 2018.12 maps can be used, otherwise the request will be rejected.

In example, when asking for date range between January and February 2020 it is recommended to use 2020.03 map version. When asking for data from September 2016, it is advised to use 2016.12 map version.

Request URL

https://<baseURL>/traffic/trafficstats/maps/<versionNumber>?key=<apiKey>

Required POST headers

Content-Type: application/json

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.

Parameter Description Req'd? Type / Values Default Value
baseURL Base URL for calling the API. Yes api.tomtom.com
versionNumber Service version number. The current value is 1. Yes 1
apiKey Authorization key for access to the API. Yes API Key

JSON request parameters

Below JSON parameters refer to POST request.

Parameter Description Req'd? Type / Values Default Value
geometry Geometry of the network in GeoJSON format. Supported geometry types are Polygon and MultiPolygon. See RFC 7946 Yes Object
dateRange Ranges of dates for calculations, this affects the list of available maps. It consists of Date from and Date to in YYYY-MM-DD format. Yes Object

JSON example request

{
   "geometry":{
      "type":"Polygon",
      "coordinates":[
         [
            [
               19.433904442477314,
               51.817044485417625
            ],
            [
               19.407226981038946,
               51.784535147052594
            ],
            [
               19.42841202394746,
               51.7401001934999
            ],
            [
               19.471959056587565,
               51.72430675993962
            ],
            [
               19.500205780461073,
               51.73135374291081
            ],
            [
               19.500205780461073,
               51.75831652893055
            ],
            [
               19.493144099496106,
               51.80904062983166
            ],
            [
               19.44959706685603,
               51.8194696155619
            ],
            [
               19.433904442477314,
               51.817044485417625
            ]
         ]
      ]
   },
   "dateRange":{
      "from":"2019-01-01",
      "to":"2020-01-31"
   }
}

Response example

{
	"maps": [
		"2018.12",
		"2019.03",
		"2019.06",
		"2019.09",
		"2019.12"
	]
}