Traffic API Developer's Guide

Selecting Tile Color Depth

The Traffic API allows requests to select the size of the color depth of the tile to be delivered in the response. Such requests follow the same pattern as requests for traffic flow tile overlays, but require the parameter res to select the tile size and/or depth to determine the required color depth.

Color Depth, [Z]/[X]/[Y] Addressing

User Story

The user wants to obtain a traffic tile, using the [Z]/[X]/[Y] addressing scheme. The response is to deliver a tile with color depth of 8 bits

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} [png8], the format of the response image, which specifies the required color depth

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/png8
?app_code={YOUR_APP_CODE}&app_id={YOUR_APP_ID}

Response

The response to both the requests that stipulate tile color depth delivers the tile shown below.

Figure 1. Flow Tile Request as 8-bit 8-bit flow tile

Color Depth, Quadkey Addressing

User Story

The user wants to obtain a traffic tile, using a quadkey. The color depth of the tile delivered by the response is to be 8 bits.

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.

Note that quadkey addressing makes it necessary to specify the color depth via the query parameter depth.

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
  depth [depth=8bit], an indication color depth

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
&depth=8bit

Response

The result is an 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.