Available Maps
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
Use this endpoint to check what map versions are available in all Traffic Stats APIs. Map versions should be selected based on map type, date Range(s) and route(s)/network provided in the create report POST request. Traffic Stats supports two types of maps GENESIS and ORBIS.
Last 2 years
When analysing last two years of data (this is a moving time window), you can pick any available map version you like.
We offer variety map versions released each quarter. For example, when asking for a date range between January and February 2024, you can use the 2024.03
map version.
However for best performance we suggest selecting map version according to tables presented in the next section.
Data older than 2 years
If you choose to analyse data older than 2 years, there is only one map version assigned to already map-matched data. For details which map version covers given period, see below.
Genesis
The following data table shows the supported date ranges and used map versions (does not apply for Japan, for Japan see next table).
Date Range Support | Map Type | Map Version |
---|---|---|
2008-01-01 - 2019-01-31 | GENESIS | 2016.12 |
2019-02-01 - 2020-12-31 | GENESIS | 2018.12 |
2021-01-01 - 2021-12-31 | GENESIS | 2020.12 |
2022-01-01 - 2022-12-31 | GENESIS | 2021.12 |
2023-01-01 - 2023-12-31 | GENESIS | 2022.12 |
2024-01-01 - 2024-12-31 | GENESIS | 2023.12 |
2025-01-01 - 2025-12-31 | GENESIS | 2024.12 |
... | ... | ... |
The following data table shows the supported date ranges and used map versions for Japan.
Date Range Support | Map Type | Map Version |
---|---|---|
2020-07-16 - 2022-12-31 | GENESIS | 2021.09 |
2023-01-01 - 2023-12-31 | GENESIS | 2022.12 |
2024-01-01 - 2024-12-31 | GENESIS | 2023.12 |
2025-01-01 - 2025-12-31 | GENESIS | 2024.09 |
... | ... | ... |
Orbis
The following data table shows the supported date ranges and used map versions. Orbis currently supports date ranges which start on 2023-01-01 or later.
Date Range Support | Map Type | Map Version |
---|---|---|
2023-01-01 - 2024-12-31 | ORBIS | 2024.09 |
2025-01-01 - 2025-12-31 | ORBIS | 2024.12 |
... | ... | ... |
Map versions from tables are using data which are already map-matched that:
- reduces calculation time,
- delivers results faster,
- allows bigger scale analyses,
- offers stable map version across many months in the same year.
General advice
If you are not sure, which map version should be used, you can skip this parameter in request, and we will pick map version which fits best your request.
Request data
HTTPS method: POST
Constants and parameters enclosed in curly brackets { } must be replaced with their values.
URL format
https://api.tomtom.com/traffic/trafficstats/maps/2?key={Your_API_Key}
Required headers
Header | Value |
---|---|
Content-Type |
|
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 |
---|---|
| Authorization key for access to the API. |
Request POST body example - JSON
1{2 "geometry": {3 "type": "Polygon",4 "coordinates": [5 [6 [19.433904, 51.817044],7 [19.407226, 51.784535],8 [19.428412, 51.740100],9 [19.471959, 51.724306],10 [19.500205, 51.731353],11 [19.500205, 51.758316],12 [19.493144, 51.809040],13 [19.449597, 51.819469],14 [19.433904, 51.817044]15 ]16 ]17 },18 "dateRange": {19 "from": "2024-01-01",20 "to": "2024-12-31"21 },22 "mapType": "GENESIS"23}
Request POST body parameters - JSON
The following JSON parameters refer to the POST request body.
Required parameters | Description |
---|---|
| Geometry of the network which will be used in Area Analysis
or Traffic Density job
or geometry covering all routes which will be used
in Route Analysis job
in GeoJSON format. |
| Range of dates covering all days which will be used in job. |
| Map type to be used in job. Values: GENESIS or ORBIS |
Response data
Response example - JSON
1{2 "maps": [3 {4 "mapType": "GENESIS",5 "mapVersion": "2016.12"6 },7 {8 "mapType": "GENESIS",9 "mapVersion": "2018.03"10 },11 {12 "mapType": "GENESIS",13 "mapVersion": "2018.06"14 },15 {16 "mapType": "GENESIS",17 "mapVersion": "2018.09"18 },19 {20 "mapType": "GENESIS",21 "mapVersion": "2018.12"22 },23 {24 "mapType": "GENESIS",25 "mapVersion": "2019.03"26 },27 {28 "mapType": "GENESIS",29 "mapVersion": "2019.06"30 },31 {32 "mapType": "GENESIS",33 "mapVersion": "2019.09"34 },35 {36 "mapType": "GENESIS",37 "mapVersion": "2019.12"38 },39 {40 "mapType": "GENESIS",41 "mapVersion": "2020.03"42 },43 {44 "mapType": "GENESIS",45 "mapVersion": "2020.06"46 },47 {48 "mapType": "GENESIS",49 "mapVersion": "2020.09"50 },51 {52 "mapType": "GENESIS",53 "mapVersion": "2020.12"54 },55 {56 "mapType": "GENESIS",57 "mapVersion": "2021.03"58 },59 {60 "mapType": "GENESIS",61 "mapVersion": "2021.06"62 },63 {64 "mapType": "GENESIS",65 "mapVersion": "2021.09"66 },67 {68 "mapType": "GENESIS",69 "mapVersion": "2021.12"70 },71 {72 "mapType": "GENESIS",73 "mapVersion": "2022.03"74 },75 {76 "mapType": "GENESIS",77 "mapVersion": "2022.06"78 },79 {80 "mapType": "GENESIS",81 "mapVersion": "2022.09"82 },83 {84 "mapType": "GENESIS",85 "mapVersion": "2022.12"86 },87 {88 "mapType": "GENESIS",89 "mapVersion": "2023.03"90 },91 {92 "mapType": "GENESIS",93 "mapVersion": "2023.06"94 },95 {96 "mapType": "GENESIS",97 "mapVersion": "2023.09"98 },99 {100 "mapType": "GENESIS",101 "mapVersion": "2023.12"102 },103 {104 "mapType": "GENESIS",105 "mapVersion": "2024.03"106 },107 {108 "mapType": "GENESIS",109 "mapVersion": "2024.06"110 },111 {112 "mapType": "GENESIS",113 "mapVersion": "2024.09"114 },115 {116 "mapType": "GENESIS",117 "mapVersion": "2024.12"118 },119 {120 "mapType": "GENESIS",121 "mapVersion": "2025.03"122 }123 ]124}