Map Tile API Developer's Guide

Traffic Tile

This article shows requests for map tiles that contain traffic information.

User story

The user wants to obtain a map tile displaying the current traffic conditions in a part of London and another tile that displays the same location, but this time with only traffic conditions and no map in the background.

Request Summary

The following list summarizes the elements required to create a request matching the user story and shows, in square brackets, how those elements are used in the example(s) below. Note that the request example also uses the authentication parameters.

Resource: maptile [traffictile] or flowtile, see also (resource) type
URL variables: {map id} [newest], see also Requesting the Right Map Version
  {scheme} [normal.day], see also scheme
  {zoom}/{column}/{row} [15/16358/10898], see also The Mercator Projection
  {size} [256], see also size
  {format} [png8], see also format

Request for a Traffic Map Tile

The code block below demonstrates a complete request for a traffic map tile.

https://1.traffic.maps.cit.api.here.com
/maptile/2.1/traffictile/newest/normal.day/15/16358/10898/256/png8
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}

Response to Traffic Map Tile Request

The response contains the following image.

Figure 1. Traffic tile for a part of London

Request for a Traffic Only Tile

The code block below demonstrates a request for a traffic tile, using the flowtile resource.

https://1.traffic.maps.cit.api.here.com
/maptile/2.1/flowtile/newest/normal.day/15/16358/10898/256/png8
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}

Response to Traffic Only Tile Request

The response contains the image below. Note that the tile contains a transparent background, which is shown here in black.

Figure 2. Transparent traffic tile for a part of London

Request for a Traffic Map Tile with Minimum Traffic Congestion Level

The code block below demonstrates a complete request for a traffic map tile where no free flow is rendered.

https://1.traffic.maps.cit.api.here.com
/maptile/2.1/traffictile/newest/normal.day/14/8683/5379/256/png8
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&min_traffic_congestion=heavy

Response to Traffic Map Tile Request with Minimum Traffic Congestion Level

The response contains the following image.

Figure 3. Traffic tile with minimum traffic congestion level "heavy"