event.drive.state

Payload JSON

{
   "eventSubscriptionId":"517db07f-6e95-475e-8cc0-a371f9deed2b",
   "eventType":"event.drive.state",
   "eventId":"c37f8ac9-8206-4f95-afd1-74e442d09c07",
   "assetId":"2412ba2f-4499-4933-a9ce-69f6a38f44ee",
   "unitId":"traxee:358014094033866",
   "eventData":{
      "registeredOn":"2021-03-26T22:20:59Z",
      "fuel":37,
      "mileage":62318,
      "latitude":51.1655,
      "longitude":3.5117,
      "state":"rolling"
   }
}

Field level Description

Field	Type	Description
eventSubscriptionId	String (UUID)	A unique identifier representing the subscription through which this event was delivered. It ensures traceability between the event and the organization's registered RMS subscription.
eventType	String	Indicates the type of event transmitted. Here, event.drive.state signifies a driving‑state update from the asset.
eventId	String (UUID)	A globally unique identifier assigned to this specific event instance. Useful for event deduplication, tracking, and audit logging.
assetId	String (UUID)	Identifies the physical asset (e.g., vehicle, trailer, equipment) associated with this event. Used to correlate telemetry with a specific asset in fleet management systems.
unitId	String	A unique identifier of the telematics device generating the event. It often includes a namespace (e.g., traxee:) followed by the device's serial or IMEI-like identifier.
eventData	Object	Contains all driving‑state‑related telemetry recorded at the time of the event.
registeredOn	DateTime (ISO 8601 timestamp, UTC)	Timestamp indicating when the driving‑state data was recorded by the telematics unit. Expressed in UTC to maintain consistent interpretation across systems.
fuel	Number (percentage or system‑specific fuel unit)	Represents the current fuel level of the asset at the time of the event. Enables monitoring of fuel consumption, trip readiness, and refueling planning.
mileage	Number (kilometers)	Indicates the total cumulative distance traveled by the asset up to the event timestamp. Supports maintenance scheduling, utilization analysis, and trip reporting.
latitude	Number (decimal degrees)	The asset's recorded geographic latitude at the time of the event, using the WGS‑84 coordinate standard.
longitude	Number (decimal degrees)	The asset's recorded geographic longitude at the event timestamp, also in WGS‑84 format.
state	String	Describes the driving condition of the asset at the time of the event. Example values may include: rolling — The asset is started moving, but unsure if this represents a real drive (maybe just re-parking the asset) driving — Confirmed motion of the asset. stopping — The asset came to a standstill, but unsure if this represents a real standstill (maybe just stopping at the traffic). standstill — Confirmed stop of the asset. unknown — The state is unknown of the asset.