Traffic API Developer's Guide

Filtering Traffic Incident Data

The HERE Traffic API supports requests for traffic incident data from a specific geographic area (defined by a geospatial filter). The response includes data in XML or JSON format.

Geospatial Inclusion

A response includes traffic incident items based on their point of origin. So an incident in the response may potentially contain a geolocation outside the area indicated by the geospatial filter in the request. The code example below shows the GEOLOC/ORIGIN parameter used to determine if an item falls within the requested response boundaries.

...
<GEOLOC>
  <ORIGIN>
    <LATITUDE>37.7894</LATITUDE>
    <LONGITUDE>-122.38732</LONGITUDE>
  </ORIGIN>
  <TO>
    <LATITUDE>37.8094693</LATITUDE>
    <LONGITUDE>-122.3657107</LONGITUDE>
  </TO>
</GEOLOC>
...

Incident Types and Filtering

Incident filters allow you to tailor incident requests to specific requirements. The filters support selection based on status, criticality, TMC table IDs, profiles, or start and end times.

In addition, traffic incidents are classified according to incident type:

Accident
Congestion
Construction
Disabled vehicle
Mass transit
Miscellaneous
Other news
Planned event
Road hazard
Weather

Localization Defaults

By default, incident reports included in the response are localized based on their geographic origin. This means the time values are shown in local time and format, and message strings are in the default language for the country identified by the geospatial filter.

The table below shows the default languages for each supported country.

Table 1. Default Traffic Incident Reports Language
Country	Default Incident Reports Language
Austria	German (de)
Belgium	Dutch (nl)
Canada	English (en)
Denmark	Danish (da)
Finland	Finnish (fi)
France	French (fr)
Germany	German (de)
Greece	Greek (el)
Ireland	English (en)
Italy	Italian (it)
Luxembourg	French (fr)
Mexico	Spanish (es)
Netherlands	Dutch (nl)
Norway	Norwegian (no)
Poland	Polish (pl)
Portugal	Portuguese (pt)
Russia	Russian (ru)
South Africa	English (en)
Sweden	Swedish (sv)
Switzerland	German (de)
Turkey	Turkish (tr)
UK	English (en)
USA	English (en)

Supported Translation Languages

For the list of supported languages for incidents, see Supported Translation Languages.