Map Tile API Developer's Guide

Traffic Tiles

Traffic related tiles are used to display the traffic flow on the road network and to highlight congestion. This article provides basic information about traffic tiles, explains how to access them and describes the available options. It also demonstrates the visual styles used by the different types of traffic tiles.

Traffic Coverage

The HERE Map Tile API supports traffic tiles for the regions listed in Traffic Coverage.

Please note that even if traffic information is available for a specific country, not all of the road network and road classes (for example, highways, main roads, local streets) might be covered. The quality and range of traffic data for the covered areas and road classes varies between countries and depends on the available traffic data sources and providers.

Traffic Visualization

Traffic tiles display the traffic flow on the roads. They reflect the traffic congestion on the road network, which is presented to the user by color coded lines drawn along the affected streets and roads. The displayed traffic congestion distinguishes between four congestion levels:

Free Flow (green):
Road segments where the average speed of the traffic is around the expected free flow speed, mostly due to a small volume of cars.
Heavy (yellow):
Road segments with a higher volume of cars, which would lead to an average speed that is less than the expected free flow speed.
Queuing (red):
Road segments with a very high volume of cars that would lead to an average speed closer to stopping and that would reduce the distance between 2 successive vehicles, which would have the effect of creating a queue.
Blocked (black):
Road segments that are blocked, due to construction sites, accidents and such.

Traffic Tile Types

There are four traffic tile types that can be rendered which differ in the visual style of the image. The images below demonstrate the possible types.

Traffic Tile Flow Tile Flow Base Tile Flow and Label Tile
map tile with traffic flow transparent tile with only traffic flow base tile (no labels) with traffic flow tile with traffic flow and labels

Rendering by Traffic Congestion Levels

Based on the congestion levels listed above, it is possible to render traffic lines only for those road segments where a certain minimum congestion level of traffic is reached.

heavy traffic and above queuing traffic and above

Real-Time Traffic And Traffic Patterns

By default, traffic tiles will show real-time traffic, representing the traffic situation as it is at the time of the request.

Besides this, it is also possible to request a traffic tile showing the typical traffic pattern for a specific time and day during the week. To get a traffic pattern tile, add a &time parameter to the request, specifying the date and time for which to display the traffic situation. Based on historic information, the tile will then display typical traffic situation for that date and time. See Traffic Tile Resources for detailed information.

Validity of Traffic Data

It is important to bear in mind that traffic information remains valid only for a short period of time (about 1-5 minutes). For this reason, client applications should not cache traffic tiles.

A Traffic Tile Request

The following example request obtains a basic traffic tile.

See the API Reference for detailed information about the possible options.