Vehicle standstill data Push

Introduction

During a trip a vehicle could be standing still for a while. Usually this is planned and happens on a location where goods are loaded and unloaded. However, it could also happen in between planned stops. For example when the driver is taking a break or experiences any delaying circumstances such as traffic jams. It can be useful to analyze this information and compare it to the planning. This gives insight in how accurate planning data was and how to improve it in the future.

Simacan provides this data in the realized standstill data push. The data is pushed once a trip has finished. Unlike the Planning Push and Realized Trip Push the top level entity is not the trip but the vehicle. Since it could be possible that standstills are detected for a vehicle, but no known trip is coupled to that vehicle.

The goal of this page is to explain the structure of the OTM5 messages that are shared using the asset-push. For further information on how to initiate a connection see the overview page.

Message Structure

The messages in the asset-push follow the OTM5 Trip Profile.

General structure

  • Sensor/licensePlate: The message will contain sensor (e.g. GPS device) information, a license plate or both. This information can then be used on the consumer side to identify the vehicle.
  • actions: This section includes an array of standstill actions (expressed as generic actions in OTM5) that occurred during a trip. It should contain a move ID to link the vehicle with the trip and specify the exact part of the trip where the standstill occurred.
  • description: This field provides a human readable string describing the reason for the standstill such as a traffic jam, an accident, or other causes.
Copy
Copied
vehicle
  sensors
    sensor
      id
      externalAttributes
        sensorId
        systemId
  licensePlate
  actions
    genericAction
      start/endTime
      description
      move
        associationType
        id

Full Message Example

Here is an example of an realized standstill message. trips, however it contains less details since those are not relevant for timeliness.

Copy
Copied
{
    "entityType": "vehicle",
    "licensePlate": "ODJ-71-L",
    "sensors": [
        {
            "entity": {
                "id": "51bf33f60-b972-4331-86c3-77cfa2e4jf84a",
                "externalAttributes": {
                    "sensorId": "1-42797-5306831A3F",
                    "systemId": "38gh4e8nf8e93jdb"
                }
            },
            "associationType": "inline"
        }
    ],
    "actions": [
        {
            "entity": {
                "lifecycle": "realized",
                "description": "Unknown standstill type",
                "timeFormat": "dateTime",
                "startTime": "2024-06-21T11:53:40Z",
                "endTime": "2024-06-21T12:22:06Z",
                "move": {
                    "uuid": "ec875tgg-0b45-58e6-b933-4991759gj05",
                    "entityType": "move",
                    "associationType": "reference"
                },
                "actionType": "genericAction"
            },
            "associationType": "inline"
        },
        {
            "entity": {
                "lifecycle": "realized",
                "description": "Unknown standstill type",
                "timeFormat": "dateTime",
                "startTime": "2024-06-21T12:31:47Z",
                "endTime": "2024-06-21T12:34:36Z",
                "move": {
                    "uuid": "ec87c862-0b45-58e6-b933-499fd1725405",
                    "entityType": "move",
                    "associationType": "reference"
                },
                "actionType": "genericAction"
            },
            "associationType": "inline"
        },
        {
            "entity": {
                "lifecycle": "realized",
                "description": "Unknown standstill type",
                "timeFormat": "dateTime",
                "startTime": "2024-06-21T13:13:14Z",
                "endTime": "2024-06-21T13:14:30Z",
                "move": {
                    "uuid": "ec4fr44fp-0b45-58e6-b933-499fai384bfu",
                    "entityType": "move",
                    "associationType": "reference"
                },
                "actionType": "genericAction"
            },
            "associationType": "inline"
        },
    ],
}