Request incident data

A basic incident request consists of a geospatial filter (in) and the type of location referencing to return (locationReferencing). The response will contain the traffic incidents on the road segments that are within the requested area.

The geospatial filter in can be a circle, a bounding box or a corridor, each having its own format. In our example below, we will use a circle specified by a point with latitude and longitude and a radius: in=circle:52.50811,13.47853;r=2000.

For more details on the geospatial filtering types, see Geospatial filtering.

The locationReferencing can be one or more out of tmc, olr, shape. Specify only the location types that you are able to interpret to ensure that you don't get any data which you can't process.

For more information on the location referencing types, see Location referencing.

The returned data will be an array of incident items, each having a location and an incidentDetails element. Each location has a length in meters and the available location references of the location, depending on which were requested by the locationReferencing parameter.

The incidentDetails element of each incident item carries details such as start-time and end-time, AlertC code, and description of the incident.

curl -H "Authorization: Bearer $TOKEN" "https://data.traffic.hereapi.com/v7/flow?in=circle:52.50811,13.47853;r=2000&locationReferencing=olr"

curl "https://data.traffic.hereapi.com/v7/flow?in=circle:52.50811,13.47853;r=2000&locationReferencing=olr&apiKey=$API_KEY"

{
   "sourceUpdated": "2021-07-06T10:22:01Z",
   "results": [
       {
           "location": {
               "length": 9310.0,
               "olr": "CCkBEAAlJAUSUiRTrwAJBQQAAZAACgUEAMhIANOV8MIACQUEAAEtADAAAA=="
           },
           "incidentDetails": {
               "id": "3195531507295233286",
               "originalId": "3195531507295233286",
               "startTime": "2019-12-03T23:00:00Z",
               "endTime": "2023-03-12T22:59:59Z",
               "entryTime": "2021-07-04T02:18:03Z",
               "roadClosed": true,
               "criticality": "minor",
               "type": "other",
               "codes": [
                   803,
                   1851
               ],
               "description": {
                   "value": "Bei Leverkusen - Vorübergehende Begrenzung der Breite 7.0 m. Bauarbeiten auf Abschnitt."
               },
               "summary": {
                   "value": "Bei Leverkusen - Vorübergehende Begrenzung der Breite 7.0 m. Bauarbeiten auf Abschnitt."
               },
               "vehicleRestrictions": [
                   {
                       "vehicleType": "motorVehicle",
                       "restrictionType": {
                           "size": {
                               "dimension": "width",
                               "value": {
                                   "greaterThan": 0.0
                               }
                           }
                       }
                   }
               ]
           }
       },
       {
           "location": {
               "length": 2087.0,
               "olr": "CCsBEAAnJgT0kSRLKwAJBQQAAa4ACgUEAJZ4APN5+WUACQUEAAEmADCCKoQq"
           },
           "incidentDetails": {
               "id": "3704457286517849505",
               "originalId": "3704457286517849505",
               "startTime": "2021-07-04T02:18:01Z",
               "endTime": "2025-12-31T22:59:00Z",
               "entryTime": "2021-07-04T02:18:03Z",
               "roadClosed": true,
               "criticality": "major",
               "type": "other",
               "codes": [
                   494,
                   803,
                   1851
               ],
               "description": {
                   "value": "Zwischen Leverkusen-West und Köln-Niehl - Vorübergehende Begrenzung der Breite 2.3 m. Bauarbeiten auf Abschnitt. Gesperrt für Schwerlastverkehr über 3.5 t."
               },
               "summary": {
                   "value": "Zwischen Leverkusen-West und Köln-Niehl - Vorübergehende Begrenzung der Breite 2.3 m. Bauarbeiten auf Abschnitt. Gesperrt für Schwerlastverkehr über 3.5 t."
               },
               "vehicleRestrictions": [
                   {
                       "vehicleType": "lorry",
                       "restrictionType": {
                           "weight": {
                               "weightType": "vehicleWeight",
                               "value": {
                                   "greaterThan": 0.0
                               }
                           }
                       }
                   }
               ]
           }
       },
       ...
   ]
}

The results array above has been truncated for readability.

The language used by description and summary is the original language of the country that the incident belongs to. To get the information in a different language, use the lang parameter, for example, lang=en-US for the US English language.

If no traffic information is available at the requested location, the results will be an empty array:

{"sourceUpdated":null,"results":[]}