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

Raster Traffic Incident Tiles

The TomTom Traffic Tile service serves 256 x 256 pixel tiles showing traffic incidents. 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. Traffic tiles render graphics to indicate traffic on the roads in the specified area.

Request

Format

http(s)://<baseURL>/traffic/map/<versionNumber>/tile/incidents/<style>/<zoom>/<x>/<y>.<format>?key=<apiKey>[&t=<t>]

Example

https://api.tomtom.com/traffic/map/4/tile/incidents/s3/12/2044/1360.png?key=<apiKey>

Parameters

The table below describes all of the parameters that can be used in a request. Parameters and values are case-sensitive. 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 Req'd? 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.
s1 creates traffic lines with colored chevrons indicating severity. s2 and s3 create plain lines with different degrees of glow.
Yes
  • s1
  • s2
  • s3
  • night
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
apiKey API Key valid for requested service. Yes API Key
format The mime type for the response. Yes
  • png
  • gif
[t] Reference value for the state of traffic at a particular time, obtained from the Viewport API call. It is updated every minute, and is valid for two minutes before it times out. Use -1 to get the most recent traffic information. Default: most recent traffic information. No String -1

 

Response

Http Response Codes

Code Meaning and Possible Causes
200 OK
400 Bad request, usually due to malformed syntax

  • zoom n is out of range 0 <= zoom < 19: the requested zoom level is out of the possible range
  • x n is out of range [0,m]: the requested x coordinate is out of the possible range (the value of m will vary depending on zoom level)
  • y n is out of range [0,m]: the requested y coordinate is out of the possible range (the value of m will vary depending on zoom level)
  • Unknown Content Type: nnn: the requested content type is not supported
403 Forbidden: Supplied API key is not valid for this request
500 Internal Server Error