event.drive.state

Payload JSON

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

Field level Description

Field	Type	Optional/Required	Description
eventSubscriptionId	String (UUID)	Required	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	Required	Indicates the type of event transmitted. Here, event.drive.state signifies a driving‑state update from the asset.
eventVersion	Number	Required	eventVersion indicates the schema version of the event, allowing producers and consumers to interpret the event consistently as the schema evolves.
eventId	String (UUID)	Required	A globally unique identifier assigned to this specific event instance. Useful for event deduplication, tracking, and audit logging.
assetId	String (UUID)	Required	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	Required	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.
registeredOn	DateTime (ISO 8601 timestamp, UTC)	Required	The timestamp representing when the event was detected and recorded by the device.
eventData	Object	Required	Contains all driving‑state‑related telemetry recorded at the time of the event.
ref	Object	Optional
ref.fuel	Number (percentage or system‑specific fuel unit)	Optional	Represents the current fuel level of the asset at the time of the event. Enables monitoring of fuel consumption, trip readiness, and refueling planning.
ref.mileage	Number (kilometers)	Optional	Indicates the total cumulative distance traveled by the asset up to the event timestamp. Supports maintenance scheduling, utilization analysis, and trip reporting.
ref.latitude	Number (decimal degrees)	Optional	The asset's recorded geographic latitude at the time of the event, using the WGS‑84 coordinate standard.
ref.longitude	Number (decimal degrees)	Optional	The asset's recorded geographic longitude at the event timestamp, also in WGS‑84 format.
state	String	Required	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.