Traffic APIRaster Flow Tiles
The TomTom Flow Tile service serves 256 x 256 pixel tiles showing traffic flow. All tiles use the same grid system. Because the traffic tiles use transparent images, they can be layered on top of map tiles to create a compound display. The Traffic Flow tiles use colors to indicate either the speed of traffic on different road segments, or the difference between that speed and the free-flow speed on the road segment in question.
Request
Format
http(s)://<baseURL>/traffic/map/<versionNumber>/tile/flow/<style>/<zoom>/<x>/<y>.<mimeType>?key=<apiKey>[&thickness=<thickness>]
Example
https://api.tomtom.com/traffic/map/4/tile/flow/absolute/12/2044/1360.png?key=<apiKey>
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, which are highlighted with [square brackets], may be used. If there is a default value that will be assumed when an optional parameter is not used, it is shown in the table.
| Parameter | Description | Reqd? | Type / Values | Default Value |
|---|---|---|---|---|
| baseURL | Base URL for calling TomTom services. | Yes | api.tomtom.com |
— |
| versionNumber | Version of the service to call. The current version is 4. | Yes | 4 | — |
| style | The style to be used to render the tile. When style is absolute, the colors will reflect the absolute speed measured. Calls using relative style return the speed relative to free-flow, highlighting areas of congestion. Relative-delay displays relative speeds only where they are different from the freeflow speeds. Reduced-sensitivity displays relative speeds but larger difference from freeflow (depending on FRC) is required for segment to change the color. |
Yes |
|
— |
| zoom | Zoom level of tile to be rendered. | Yes | 0 .. 18 | — |
| x | x coordinate of tile on zoom grid. | Yes | 0..2 zoom -1 | — |
| y | y coordinate of tile on zoom grid. | Yes | 0..2 zoom -1 | — |
| mimeType | The mime type for the response. | Yes |
png |
— |
| apiKey | API Key valid for requested service. | Yes | API Key | — |
| [thickness] | The segment width multiplier. | No | 1..20 | 10 |
Note that the flow layer can create a patchwork tile effect if the flow traffic data changes between calls of adjacent tiles.
Response
Http Response Codes
| Code | Meaning and Possible Causes |
|---|---|
| 200 | OK |
| 400 | Bad request, usually due to malformed syntax
|
| 403 | Forbidden: Supplied API key is not valid for this request |
| 500 | Internal Server Error |