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 theGEOLOC/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.
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.