GPS Message
Sends GPS location updates to the webhook based on the configured tracking interval.
Event Type: GPS_MESSAGE
Trigger Condition
Webhook subscription to the GPS_MESSAGE event is mandatory.
The event is published to the configured webhook whenever the device sends GPS data according to the set tracking interval.
The tracking frequency must be configured at the customer level. If not explicitly set, the system defaults to a 2 minute tracking frequency.
Example Payload
{
"id": "24005889-ff01-4e98-aee5-c9f25269db3e",
"type": "GPS_MESSAGE",
"spare": 0,
"speed": 50,
"course": 88,
"offset": 150,
"userId": "79f63e90-a0cf-11ef-94bc-ad932108ba0d",
"assetNo": "",
"groupId": "060b952b-28c5-11e7-8384-911724969dc5",
"jmsType": "",
"roaming": 0,
"stateId": 0,
"altitude": 12,
"deviceId": "798924df-a0cf-11ef-94bc-d721153776c0",
"dilution": 8,
"latitude": 49.4064494,
"location": {
"latitude": 49.4064494,
"longitude": 92.3528425
},
"needHelp": false,
"obdSpeed": 3,
"odometer": 1890,
"userName": "5134555555 .",
"breakDown": false,
"eventCode": 0,
"fixStatus": 0,
"groupName": "Default Group",
"imei_meid": "513455555551345555",
"inputBit0": 0,
"inputBit1": 0,
"inputBit2": 0,
"inputBit3": 0,
"inputBit4": 0,
"inputBit5": 0,
"inputBit6": 0,
"inputBit7": 0,
"insideHOO": true,
"longitude": 92.3528425,
"network3G": 0,
"processed": true,
"tripState": "ACTIVE",
"vehicleId": "7988d6be-a0cf-11ef-94bc-0fce622cd4cc",
"customerId": 5134,
"eventIndex": 0,
"fixQuality": 0,
"invalidFix": 0,
"noOfAccums": 0,
"tripNumber": 12345,
"unitStatus": 0,
"commonState": 0,
"dataService": 0,
"deviceSpeed": 3,
"messageType": "GPS_MESSAGE",
"temperAlert": false,
"vehicleName": "5134555555",
"currentState": 0,
"deviceSerial": "5134555555",
"deviceTypeId": 1,
"dimentionFix": 0,
"lastKnownLat": 0,
"lastKnownLon": 0,
"locationTime": 1731400024000,
"messageIndex": "463148",
"partitionKey": "5134555555",
"tripDistance": 3,
"vendorTypeId": 1,
"airFilterClog": false,
"messageTypeId": 1,
"partialUpdate": false,
"clutchOverride": false,
"deviceAvgSpeed": 18,
"deviceMaxSpeed": 20,
"lowOilPressure": false,
"networkService": 0,
"satelliteCount": 13,
"storedLocation": false,
"tripIdlingTime": 50,
"unitStatusBit0": 0,
"unitStatusBit1": 0,
"unitStatusBit2": 0,
"unitStatusBit3": 0,
"virtualTripEnd": false,
"vehicleOdometer": false,
"voiceCallActive": 0,
"fixStatusPredict": 0,
"batteryPercentage": 0,
"fixStatusHistoric": 0,
"privacyModeEnable": false,
"batteryDisonnected": false,
"batteryNotCharging": false,
"commStateConnected": 0,
"fixStatusCorrected": 0,
"fixStatuslastKnown": 0,
"messageEventTypeId": 0,
"commStatusAvaliable": 0,
"lastKnownFixQuality": 0,
"protocolVersionIdChange": true
}
Reference
Field | Description |
---|---|
id | The unique reference ID for the given event in the system
Example: |
type | Type of Event
Example: |
speed | Speed of the Vehicle in kilometers per hour
Example: |
offset | device timezone offset
Example: |
userId | The unique ID of the User
Example: |
assetNo | The Asset Id associated with the device. Example : TRL201 |
groupId | Logical Group ID the Device/Vehicle belongs to
Example: |
stateId | Refers to the vehicle ignition state or movement status, 0-Ignition Off and 1-Ignition On
Example: |
altitude | Indicates the vehicle’s elevation above sea level in meters
Example |
deviceId | The unique ID of the Device
Example: |
dilution | Refers to Dilution of Precision (DOP) — a measure of the quality and accuracy of the GPS signal based on satellite geometry
1–2: Ideal — High precision, 2–5: Good — Acceptable accuracy, 5–10: Moderate — May still be usable, 10+: Poor — Low GPS accuracy
Example: |
location | Current location object of the vehicle |
latitude | Latitude co-ordinate value in degrees
Example: |
longitude | Longitude co-ordinate value in degrees
Example: |
needHelp | Indicates whether a help or emergency signal has been triggered by the user or device, such as an SOS or panic alert
Example: |
obdSpeed | OBD device Speed in kilometers per hour
Example: |
odometer | Odometer Reading of the Vehicle in kilometers
Example: |
userName | Name of the User associated to the device/vehicle
Example: |
breakDown | Indicates whether the vehicle is experiencing a breakdown or technical issue at the time of the GPS message
Example: |
groupName | Name of the Group the device/vehicle is associated to
Example: |
imei_meid | IMEI or MEID of the device
Example: |
network3G | Status of 3G Network
Example: |
processed | Indicates whether the data or event has been successfully processed by system
Example: |
tripState | Represents the current status of a vehicle's trip, indicating whether the trip is active, completed, or in another state.
Example: |
vehicleId | The unique ID of the Vehicle
Example: |
customerId | The unique Azuga ID of the Customer
Example: |
tripNumber | Represents a unique identifier assigned to a specific trip, allowing the system to track and reference that particular journey or route
Example: |
messageType | Type of Message
Example: |
temperAlert | Example: |
vehicleName | Name of the Vehicle
Example: |
deviceSerial | Serial Number of the Device associated with vehicle
Example: |
deviceTypeId | ID of the Device type, 1 - Datalogger
Example: |
locationTime | Time of event Occurrence in milliseconds
Example: |
messageIndex | Represents a unique identifier for the specific message or data entry, allowing the system to track and reference this particular message within the data stream
Example: |
partitionKey | Unique identifier used to partition or organize data in the system
Example: |
tripDistance | Distance travelled in the current trip in kilometers
Example: |
vendorTypeid | ID of the Vendor type
Example: |
airFilterClog | Indicates whether the vehicle's air filter is clogged
Example: |
messageTypeId | ID of the Message Type
Example: |
partialUpdate | Indicates whether the data has been partially updated
Example: |
clutchOverride | Indicates whether the clutch override feature is active
Example: |
deviceAvgSpeed | The average speed of the device/vehicle in kilometers per hour
Example: |
deviceMaxSpeed | The maximum speed of the device/vehicle captured in kilometers per hour
Example: |
lowOilPressure | Indicates whether the vehicle is experiencing low oil pressure
Example: |
networkService | Indicates the status of the network service
Example: |
satelliteCount | The number of GPS satellites the device is currently connected to
Example: |
storedLocation | Indicates whether the device has stored a location
Example: |
tripIdlingTime | The total amount of time the vehicle spent idling during the trip in seconds
Example: |
virtualTripEnd | Indicates whether the trip has ended virtually, meaning the system marks the end of the trip without the vehicle physically stopping.
Example: |
vehicleOdometer | Indicates whether the odometer reading for the vehicle is available
Example: |
privacyModeEnable | Indicates whether privacy mode is enabled on the device
Example: |
batteryDisonnected | Indicates whether the vehicle’s battery is disconnected
Example: |
batteryNotCharging | Indicates whether the vehicle’s battery is not charging
Example: |
Updated 5 days ago