Traffic flow observed

Description

An observation of traffic flow conditions at a certain place and time. This entity is primarily associated with the Automotive and Smart City vertical segments and related IoT applications.

Data Model

• id : Unique identifier.

• type : Entity type. It must be equal to TrafficFlowObserved.

• location : Location of this traffic flow observation represented by a GeoJSON geometry.

  • Attribute type: geo:json.
  • Normative References: https://tools.ietf.org/html/rfc7946
  • Mandatory if refRoadSegment is not present.

• address : Civic address of this traffic flow observation.

  • Normative References: https://schema.org/address
  • Optional

• refRoadSegment : Concerned road segment on which the observation has been mede.

  • Attribute type: Reference to an entity of type RoadSegment.
  • Mandatory if location is not present.

• dateModified : Last update timestamp of this entity.

  • Attribute type: DateTime
  • Mandatory

• laneId : Lane identifier.

  • Attribute type: Number
  • Allowed values: Positive integer starting with 1. Lane identification is done using the conventions defined by RoadSegment which are based on OpenStreetMap.
  • Mandatory

• dateObserved : The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: dateObservedFrom, dateObservedTo.

  • Attribute type: DateTime or an ISO8601 interval represented as Text.
  • Mandatory

• dateObservedFrom : Observation period start date and time. See dateObserved.

  • Attribute type: DateTime.
  • Optional

• dateObservedTo : Observation period end date and time. See dateObserved.

  • Attribute type: DateTime.
  • Optional

• dateCreated : Entity's creation timestamp.

  • Attribute type: DateTime
  • Optional

• name : Name given to this observation.

  • Normative References: https://schema.org/name
  • Optional

• description : Description of this observation.

  • Normative References: https://schema.org/description
  • Optional

• intensity : Total number of vehicles detected during this observation period.

  • Attribute type: Number. Positive integer.
  • Optional

• occupancy : Fraction of the observation time where a vehicle has been occupying the observed laned.

  • Attribute type: Number between 0 and 1.
  • Optional

• averageVehicleSpeed : Average speed of the vehicles transiting during the observation period.

  • Attribute type: Number
  • Default unit: Kilometer per hour (Km/h).
  • Optional

• averageVehicleLength : Average length of the vehicles transiting during the observation period.

  • Attribute type: Number
  • Default unit: meter (m)
  • Optional

• congested : Flags whether there was a traffic congestion during the observation period in the referred lane. The absence of this attribute means no traffic congestion.

  • Attribute type: Boolean
  • Optional

• averageHeadwayTime : Average headway time. Headaway time is the time ellapsed between two consecutive vehicles.

  • Attribute type: Number
  • Default unit: second (s)
  • Optional

• averageGapDistance : Average gap distance between consecutive vehicles.

  • Attribute type: Number
  • Default unit: meter (m)
  • Optional

• laneDirection : Usual direction of travel in the lane referred by this observation. This attribute is useful when the observation is not referencing any road segment, allowing to know the direction of travel of the traffic flow observed.

  • Attribute type: Text
  • Allowed values: (forward, backward). See RoadSegment.laneUsage for a description of the semantics of these values.
  • Optional

• reversedLane: Flags whether traffic in the lane was reversed during the observation period. The absence of this attribute means no lane reversion.

  • Attribute type: Boolean
  • Optional

Examples of use

    {
       "id": "TrafficFlowObserved-Valladolid-osm-60821110",
       "type": "TrafficFlowObserved",
       "laneId": 1,
       "address": {
         "streetAddress": "Avenida de Salamanca",
         "addressLocality": "Valladolid",
         "addressCountry": "ES"
       },
       "location": {
         "type": "LineString",
         "coordinates": [
           [
             -4.73735395519672, 41.6538181849672
           ],
           [
             -4.73414858659993, 41.6600594193478
           ],
           [
             -4.73447575302641, 41.659585195093
           ]
         ]
       },
       "dateObserved": "2016-12-07T11:10:00/2016-12-07T11:15:00",
       "dateObservedFrom": "2016-12-07T11:10:00",
       "dateObservedTo": "2016-12-07T11:15:00",
       "averageHeadwayTime": 0.5,
       "intensity": 197,
       "capacity": 0.76
       "averageVehicleSpeed": 52.6,
       "averageVehicleLength": 9.87,
       "reversedLane": false,
       "laneDirection": "forward"
    }    

Use it with a real service

T.B.D.

Open issues