status.tpms

This section provides detailed explanations of each field contained in the Tire Pressure Monitoring System (TPMS) status event. These descriptions help integrators and end‑users understand the meaning and purpose of each data element transmitted through Raw Message Streaming (RMS).

Payload JSON

{
   "eventSubscriptionId":"517db07f-6e95-475e-8cc0-a371f9deed2b",
   "eventType":"status.tpms",
   "eventVersion":1,
   "eventId":"c37f8ac9-8206-4f95-afd1-74e442d09c07",
   "assetId":"2412ba2f-4499-4933-a9ce-69f6a38f44ee",
   "unitId":"traxee:358014094033866",
   "registeredOn":"2021-03-26T22:20:59Z",
   "eventData":{
      "tpms":[
         {
            "location":17,
            "pressure":10.2,
            "pressureStatus":"overPressure",
            "temperature":32
         }
      ]
   }
}

Field level Description

FieldTypeOptional/RequiredDescription
eventSubscriptionIdString (UUID)RequiredA unique identifier representing the subscription through which this event was delivered. It ensures traceability between the event and the organization's registered RMS subscription.
eventTypeStringRequiredIndicates the category of event generated by the system. For this payload, status.tpms identifies the event as a Tire Pressure Monitoring System status update.
eventVersionNumberRequiredeventVersion indicates the schema version of the event, allowing producers and consumers to interpret the event consistently as the schema evolves.
eventIdString (UUID)RequiredA globally unique identifier assigned to this specific event instance. Useful for event deduplication, tracking, and audit logging.
assetIdString (UUID)RequiredIdentifies the physical asset (e.g., vehicle, trailer, equipment) associated with this event. Used to correlate telemetry with a specific asset in fleet management systems.
unitIdStringRequiredA 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.
registeredOnDateTime (ISO 8601 timestamp, UTC)RequiredThe timestamp representing when the event was detected and recorded by the device.
eventDataObjectRequiredThe eventData section contains sensor readings and associated metadata captured at the time of the TPMS event.
tpmsArrayRequiredA collection of TPMS sensor readings. Each element provides detailed status information for a single wheel or sensor location on the asset.
locationIntegerRequiredNumerical identifier representing the sensor's mounting position on the asset. The specific mapping (e.g., "17" → tire position) follows the manufacturer's tire layout configuration.
pressureNumber (Decimal)OptionalThe measured tire pressure at the time the event was generated. This value enables monitoring of inflation levels for safety and efficiency.
pressureStatusStringOptionalIndicates the interpreted status of the tire pressure relative to defined thresholds. Examples include:
extremeOverPressure - Pressure is extremely high compare to recommended limits
overPressure — Pressure exceeds recommended limits
normal — Pressure is within optimal range
underPressure — Pressure is below acceptable limits
extremeUnderPressure - Pressure is extremely low compare to acceptable limits
temperatureNumber (°C)OptionalThe temperature reading from the tire's TPMS sensor. Monitoring tire temperature helps detect anomalies such as overheating or possible structural issues.