Filter Incidents by Functional Class

Roads are classified by their functional class. The table below contains the hierarchical classification of functional classes or functional road classes for road network segments:

Functional Road Class Value Functional Class Description
1 These roads are meant for high volume, maximum speed traffic between and through major metropolitan areas. There are very few, if any, speed changes. Access to this road is usually controlled.
2 These roads are used to channel traffic to Main Roads (FRC1) for travel between and through cities in the shortest amount of time. There are very few, if any speed changes.
3 These roads interconnect with First Class Roads (FRC2) and provide a high volume of traffic movement at a lower level of mobility than First Class Roads (FRC2).
4 These roads provide for a high volume of traffic movement at moderate speeds between neighborhoods. These roads connect with higher Functional Class roads to collect and distribute traffic between neighborhoods.
5 These roads' volume and traffic movements are below the level of any other road.

When requesting incidents, you can filter the response to receive only incident information related to roads with specific functional classes. The filter can refer to a single functional class or a list of functional classes.

curl \
   -X GET \
   -H "Authorization: Bearer $TOKEN" \
   'https://data.traffic.hereapi.com/v7/incidents?in=circle:52.50811,13.47853;r=2000&locationReferencing=olr&functionalClasses=2,3,4'
{
   "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.

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

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

results matching ""

    No results matching ""