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.
Traffic incident items are included in the response based on their point of origin. This means that an incident in the response may potentially contain a geolocation outside the area indicated by the geospatial filter in the request. The figure below shows the
GEOLOC/ORIGIN parameter used to determine if an item falls within the requested response boundaries.
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:
- Disabled vehicle
- Road hazard
- Planned event
- Mass transit
- Other news
By default, incident reports returned in the response are localized to their geographic origin. That 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|
|South Africa||English (en)|
Supported Translation Languages
The list of supported languages for incident translation you can find in section Supported Translation Languages.