Traffic API Developer's Guide

Requesting Traffic Flow Tile Overlays

One of the use cases for the HERE Traffic API is to obtain a traffic flow map tile overlay that can be used to provide a visual indication of the traffic conditions on the map.

Flow Overlays, [Z]/[X]/[Y] Addressing

User Story

The user wants to obtain a traffic flow tile overlay for an area near Frankfurt, Germany, using the [Z]/[X]/[Y] addressing scheme.

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 request example below. Note that the request example also uses the authentication parameters.

Resource: tiles [tiles]
URL variables: {zoom}/{column}/{row} [8/134/86], the [Z]/[X]/[Y] (tile) addressing scheme, see also The Mercator Projection
  {size} [256], the resolution of the response image
  {format} [png32], the format of the response image

Request

A request matching the user story is formulated as follows:

https://tiles.traffic.cit.api.here.com/traffic/6.0/tiles/8/134/86/256/png32
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}

Response

The response to the requests for a tile overlay for an area near Frankfurt in Germany contains the following PNG traffic flow tile overlay image:

Figure 1. Traffic flow tile Flow tile request for Frankfurt.

This is a basic request to the API for a traffic flow tile and the response. For further examples, please see Traffic Tiles.

Flow Overlays, Quadkey Addressing

User Story

The user wants to obtain a traffic flow tile overlay for an area near Frankfurt, Germany, using the quadkey addressing scheme.

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 request example below. Note that the request example also uses the authentication parameters.

Resource: tiles [tiles]
URL variables: {quadkeytraffic} [quadkeytraffic], resource endpoint, indicating that a traffic tile overlay based identified by a quadkey is required
Parameters: quadkey [quadkey=12020330], ], map tile location specified as a single value, see also Quadkeys

Request

A request matching the user story is formulated as follows:

https://tiles.traffic.cit.api.here.com/traffic/6.0/tiles/quadkeytraffic
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&quadkey=12020330

Response

The result is the same image as shown for the [Z]/[X]/[Y] version of the request under Response.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.