Filter Flow 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 flow, you can filter the response to receive only the flow 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/flow?in=circle:52.50811,13.47853;r=2000&locationReferencing=olr&functionalClasses=2,3,4'
{
   "sourceUpdated":"2021-06-08T10:07:23Z",
   "results":[
      {
         "location":{
            "description":"Alt-Friedrichsfelde",
            "length":966.0,
            "olr":"CCoBEAAmJQmadyVXRQAJBQQBAkcACgUEAYpTAAfI/7QACQUEAQK3ADAAgxM="
         },
         "currentFlow":{
            "speed":13.888889,
            "speedUncapped":14.722222,
            "freeFlow":13.888889,
            "jamFactor":1.2,
            "confidence":0.99,
            "traversability":"open"
         }
      },
      {
         "location":{
            "description":"Rosenfelder Straße",
            "length":929.0,
            "olr":"CCoBEAAmJQmeJyVXKAAJBQQBArcACgUEAYpoAPgaAEkACQUEAQJFADCDTQA="
         },
         "currentFlow":{
            "speed":13.888889,
            "speedUncapped":14.722222,
            "freeFlow":13.611112,
            "jamFactor":2.0,
            "confidence":0.99,
            "traversability":"open"
         }
      },
      ...
   ]
}

The response above has been truncated for readability.

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

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

results matching ""

    No results matching ""