HERE Real-Time Traffic API is one of 139 APIs that HERE publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Real-Time Traffic. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes
6 operations
across 3 paths,
and defines 53 schemas.
It is described by OpenAPI 3.2.0, at version 7.5.0.
Requests are made against a single base URL, https://data.traffic.hereapi.com/v7.
The identity and technical contract details declared by the specification.
Lanes
array
Provided only if there are different lane speeds along a roadway. The Lane message contains information about the speed of traffic in individual lanes in a roa…
IncidentCriticality
string
The severity of the incident that has occured, with the following possible values: low (least severe), minor, major, and critical (most severe).
SubSegments
array
Provided only if the current flow information is more precise than the road defined. If sub-segments are provided, the length of all sub-segments will add up t…
LocationTMC
object
Location reference in TMC format. This type of location reference can only be provided on roadways that are part of the TMC definition. TMC Location referencin…
8 properties
5 required
TrafficTypeRestriction
string
The type of traffic that is restricted. Possible traffic types are: | Traffic Type | |---------------| | residentsTraffic | | throughTraffic | | noThrough |
WeightRestriction
object
A restriction on the weight of a vehicle in kilograms that can pass through an area.
3 properties
1 required
BoundingBox
object
A bounding box defined by two longitudes and two latitudes.
5 properties
5 required
JunctionTraversability
string
Indicates junction traversability. Used for road closures to indicate if the closure can be crossed. | Junction Traversability | Description | |---------------…
RequestBodyIn
object
Return flow items within a geographical area. Area within which to return flow. A geographic area can be one of the following: A circular area, provided as lat…
JamFactor
number
The number between 0.0 and 10.0 indicating the expected quality of travel. When there is a road closure, the jamFactor will be 10.0. As the value approaches 10…
EmissionRestriction
string
The class of emission that is restricted. More detail about each emission type can be found in https://en.wikipedia.org/wiki/Europeanemissionstandards. Possibl…
ErrorResponse
object
Response in case of error
6 properties
6 required
IncidentItemResponse
object
Returns the requested incident item.
Coordinates
object
Coordinates lat and lon
2 properties
EquipmentTypeRestriction
string
The type of equipment that is restricted. Possible equipments are: | Equipment Type | |---------------| | withCaravan | | withTrailer | | withoutSnowChains | |…
Circle
object
A circular area, provided as latitude, longitude, and radius (in meters).
3 properties
3 required
Time
string
RFC 3339, section 5.6 as defined by either date-time or date-only 'T' partial-time (ie no time-offset).
Confidence
number
The number between 0.0 and 1.0 indicating the proportion of real time data included in the speed calculation. 0.7 < confidence <= 1.0 indicates real time speed…
Corridor
object
A corridor defined as a polyline.
3 properties
3 required
LocationDescriptionParts
object
Parts that make up the location description.
6 properties
2 required
Location
object
Defines the location affected by traffic flow or incident. There are a number of location reference schemes which may be used depending on the locationReferenc…
6 properties
1 required
SpeedUncapped
number
The average speed (in meters per second), not capped by the speed limit, that current traffic is travelling.
SegmentRefRequest
object
A reference to the HMC topology segment. The segment references can also be provided in a compact representation if refReplacements is also specified. Please r…
1 property
PlateNumberRestriction
string
The type of plate that is restricted. Possible plate types are: | Plate Type | |---------------| | evenNumberPlate | | oddNumberPlate |
FlowResponse
object
Returns flow items within the specified area.
3 properties
1 required
LocationShapeLink
object
Points describing a single link. At least 2 points will be present in each link. The points of a link are consecutive, forming the polyline for that link.
3 properties
3 required
LocalizedString
object
String with language code.
2 properties
2 required
OccupancyRestriction
object
A restriction on the number of persons in the vehicle that can pass through an area.
2 properties
FlowItem
object
Information about traffic flow for a specific location.
2 properties
2 required
LocationOpenLR
string
TPEG OpenLR encoded as Base 64 strings. TPEG OpenLR location referencing is a TISA standard. Please visit https://tisa.org/ for more details. TISA Specificatio…
FreeFlow
number
The free flow speed speed (in meters per second) is a reference speed provided to indicate the speed on the segment at which vehicles should be considered to b…
LocationSegmentRef
object
Defines a location by a series of reference to the HMC topology segment.
1 property
1 required
Traversability
string
Indicates whether this roadway can be driven. The possible values are given in the following table. | Traversability | Description | |-------------------------…
SegmentRef
object
A reference to the HMC topology segment. The standard representation of a segment reference has the following structure: { "ref": "{catalogHrn}:{catalogVersion…
2 properties
SegmentRefFilter
object
Topology Segment references, it defines a location by a series of reference to the HMC Topology Segment. The maximum number of supported segment references is…
3 properties
2 required
AuthError
object
Error object reported in case of authentication or authorization errors.
2 properties
1 required
IncidentDetails
object
Specific details of the incident.
19 properties
3 required
JamTendency
integer
A representation of whether the congestion is increasing, decreasing, or constant. The jam tendency may take the following values. | Jam Tendency | Description…
Lane
object
Information about Lane Level Traffic.
4 properties
1 required
IncidentsResponse
object
Returns incident items within the specified area.
3 properties
1 required
SpeedCapped
number
The average speed (in meters per second), capped by the speed limit, that current traffic is travelling.
SubSegment
object
Flow information for a sub-segment of a defined roadway.
10 properties
3 required
IncidentType
string
An open list of possible incident types. The incident type gives a high level representation of the more detailed code field which gives a numerical value mapp…
Length
number
Distance in meters between the beginning and end of a roadway or sub-segment.
SizeRestriction
object
A restriction on the size of a vehicle in centimeters that can pass through an area.
3 properties
1 required
CurrentFlow
object
Information about flow information for a specific location.
10 properties
2 required
IncidentItem
object
Information about a traffic incident.
2 properties
FuelTypeRestriction
string
The type of fuel that is restricted. Possible fuel types are: | Fuel Type | Description | |-----------|------------------------| | diesel | Only vehicles with…
VehicleRestriction
object
A single vechile restriction with vehicle and restriction types. Vehicles matching both the vehicle type and the restriction rules are NOT allowed to pass thro…
2 properties
RefReplacements
object
Dictionary of placeholders to replacement strings for the compact representation of HMC topology segment references.
LocationShape
object
Defines a location by a series of geo-coordinate describing the shape of the roadway, made up by links of the map. It may be that the returned links are not co…
1 property
1 required
LaneType
string
Identifies type of the lane, with the following possible values. | Type | Description | |------------|-------------| | 'hov' | Indicates a high-occupancy vehic…
VehicleType
string
Type of the vehicle an incident restriction applies to. | Type | |-------------------| | 'bus' | | 'car' | | 'heavyGoodsVehicle' | | 'lorry' | | 'motorcycle' |…
The full machine-readable OpenAPI contract behind this narrative.
Other APIs HERE publishes across the network.
