Congestion
The congestion describes a traffic condition in which observed vehicle speeds fall below the speed expected under free-flow conditions. It is assessed by comparing the current traffic speed with the free-flow speed for the same traffic network: the greater the speed loss relative to that reference, the more serious the current congestion is. In your instance of Flows the congestion is represented, on the map, as a set of connected congested streets.
Functionl Road Classes (FRC)
Flows handles different types (classes) of roads. Every class is numbered, from 0 to 8. The numeric value of a road class is reported into the elements lengthByHierarchy and usualityByHierarchy.
As shown in this fragment of a response:
"lengthByHierarchy": { "2": 750.0, "4": 420.0 },
"usualityByHierarchy": { "2": 0.25, "4": 0.43 },Here we have:
- a road class 2, with length 750 meters and usuality = 0.25
- a road class 4, with length 420 meters and usuality = 0.43
The FRC list:
- 0: Motorways, Freeways, Major Roads. All roads that are officially classified as motorways.
- 1: Major Roads less important than Motorways. All roads of high importance, but not officially assigned as motorways, that are part of a connection used for international and national traffic and transport.
- 2: All roads used to travel between different neighboring regions of a country. Other major roads.
- 3: Secondary Roads. All roads used to travel between different parts of the same region.
- 4: Local Connecting Roads. All roads making all settlements accessible or making parts (north, south, east, west, and central) of a settlement accessible.
- 5: Local Roads of High Importance. All local roads that are the main connections in a settlement. These are the roads where important through traffic is possible. For example, arterial roads within suburban areas, industrial areas or residential areas, or a rural road which has the sole function of connecting to a national park or an important tourist attraction.
- 6: Local Roads. All roads used to travel within a part of a settlement or roads of minor connecting importance in a rural area.
- 7: Local Roads of minor importance. All roads that only have a destination function, for example dead-end roads, roads in a residential area, alleys, narrow roads between buildings, in a park or garden.
- 8: Other roads. All other roads that are less important for a navigation system: a path, a road that is too narrow to be driven by a passenger car, bicycle paths or footpaths that are especially designed as such, stairs, pedestrian tunnels, pedestrian bridges, alleys that are too narrow to be driven through by a passenger car.
Free-flow speed
Free flow speed describes the traffic conditions where vehicles move at their desired speed, mostly uninfluenced by other vehicles or traffic control.
It is possible to use the free flow speed to estimate the congestion in the traffic network, identifying how much is the deviation from the default value set in the traffic model.
Severity
The intensity of a congestion is linked to the concept of severity.
Severity can be defined as a normalized congestion intensity based on speed loss versus free-flow conditions. It is in the range [0,1].
Severity represents "how serious the congestion is now".
It is calculated as the average severity of the streets involved in the congestion.
Usuality
The common situation of a region is linked to the concepts of usuality.
Usuality is the normalized historical likelihood that the current traffic condition is expected for the same street and region. It is in the range [0,1].
Usuality represents "how expected or unexpected a condition is based on historical data", from 0 (highly unusual) to 1 (fully usual).
Therefore, it's a property that can help to understand how expected a congestion is, separating a routine congestion, such as the daily rush hour, from unexpected events such as incidents.
If are not available historical speed profiles, the value is 1.
It is calculated as the average usuality of the streets involved, weighted by street length.
ETag
An Etag is an identifier for a specific version of data. You should retain the latest ETag value you receive.
The next time you call the same API to get data, you should use the If-None-Match request header along with the retained ETag value, so that the API will send back a full response if and only if the data changes.
See how to use ETag.