Fuel Decrease Event
Notifies when a fuel drop is detected
Event Type: FUEL_DECREASE
Trigger Condition
To ensure you're always in the loop about fuel levels, subscribing to the FUEL_DECREASE webhook event is a must. This event kicks in right when a trip begins. Additionally, it will notify you mid-trip if the fuel tank suddenly drops by 30% or more.
Example Payload
{
"inputBit7": 0,
"partialUpdate": false,
"inputBit4": 0,
"voiceCallActive": 0,
"inputBit3": 0,
"inputBit6": 0,
"inputBit5": 0,
"type": "FUEL_EVENT_MESSAGE",
"deviceId": "a800913e-f94d-11ec-8b36-1309e579cfea",
"networkService": 0,
"commStateConnected": 0,
"messageType": "FUEL_DECREASE",
"messageIndex": "128448715",
"dimentionFix": 0,
"lastKnownLon": -86.7038829,
"cumulativeFuelConsumed": 340.923,
"inputBit0": 0,
"inputBit2": 0,
"id": "1c00e8ae-9101-470e-b781-2a619e8aa1e5",
"state": null,
"inputBit1": 0,
"commStatusAvaliable": 0,
"locality": null,
"eventIndex": 0,
"assetNo": "",
"fixStatusCorrected": 0,
"deviceSerial": "1112504564",
"groupName": "Nashville",
"fuelEventType": 2,
"lastKnownTime": 1662598777000,
"jmsType": "",
"vehicleName": "NSH_004-917263",
"deviceTypeId": 1,
"destinationQueues": null,
"city": null,
"latitude": 36.3075667,
"unitStatus": 0,
"invalidFix": 0,
"dataService": 0,
"noOfAccums": 0,
"customerId": 14924,
"beaconMacAddress": null,
"tripNumber": 165,
"spare": 0,
"address": null,
"roaming": 0,
"messageEventType": null,
"stateId": 0,
"updateTime": null,
"userId": "8a9388a9-81ce-1695-0182-3af23d4b4e28",
"batteryPercentage": 0,
"currentState": 0,
"deviceProtocolMessageId": null,
"newFuelLevel": 53,
"messageEventTypeId": 0,
"zipCode": null,
"country": null,
"deviceAssociatedVIN": "1FTBW3X84LKA91870",
"beaconType": null,
"groupId": "cded3f1e-e2b8-11ec-a359-6b5ab7a8d6a8",
"vendorTypeId": 1,
"firmwareVersion": null,
"fixStatuslastKnown": 0,
"fixStatusHistoric": 0,
"longitude": -86.7038829,
"satellites": null,
"locationTime": 1662598777000,
"odometer": 66599,
"offset": -300,
"virtualTripEnd": false,
"imei_meid": "352602116841310",
"insideHOO": true,
"timeOfFix": null,
"sensorNames": null,
"tripPolyline": null,
"lastKnownLat": 36.3075667,
"fixQuality": 0,
"unitStatusBit0": 0,
"unitStatusBit2": 0,
"unitStatusBit1": 0,
"unitStatusBit3": 0,
"storedLocation": false,
"protocolVersionIdChange": false,
"accumesList": null,
"accumulators": null,
"fixStatusPredict": 0,
"network3G": 0,
"lastKnownAddress": null,
"privacyModeEnable": false,
"fixStatus": 0,
"prevFuelLevel": 98,
"vehicleId": "a800913d-f94d-11ec-8b36-0b9d11973322",
"lastKnownFixQuality": 0,
"userName": "John Burke",
"tripState": "ACTIVE",
"messageTypeId": 19,
"obdSpeed": null,
"location": {
"latitude": 36.3075667,
"longitude": -86.7038829
},
"commonState": 0,
"carrierId": null
}
Reference
Field | Description |
---|---|
type String | Type of Event - Message Event |
deviceId | The unique ID of the Device |
networkService | Indicates the status of the network service, |
messageType | Type of Message |
messageIndex | Unique index or identifier of the event message |
lastKnownLon | Last known longitude in degrees |
| Total amount of fuel consumed by the vehicle since tracking began, measured in gallons |
id | The unique reference ID for the given event in the system |
eventIndex | Example: |
assetNo | The Asset Id associated with the device, can be empty. |
deviceSerial | Serial Number of the Device associated with vehicle |
groupName | Name of the Group the device/vehicle is associated to |
fuelEventType | Indicates the type of fuel event. |
lastKnownTime | Last known time in milliseconds |
vehicleName | Name of the Vehicle |
deviceTypeId | Type identifier for device, 1-Datalogger |
dataService | Indicates whether the device had active mobile data service at the time of the event. Value 0 typically means no data service. |
customerId | The unique Azuga ID of the Customer |
tripNumber | Represents a unique identifier assigned to a specific trip, allowing the system to track and reference that particular journey or route |
roaming | Indicates whether the device was roaming on a different mobile network. |
stateId | Refers to the vehicle ignition state or movement status, 0-Ignition Off and 1-Ignition On |
userId | Unique Azuga generated ID of the user in UUID format |
batteryPercentage | Percentage of Battery at time of event in % |
newFuelLevel | The current or most recently measured fuel level at the time this event was triggered in percentage % |
deviceAssociatedVIN | Vehicle Identification Number associated to a device |
groupId | Unique Azuga generated ID of the group in UUID format |
vendorTypeId | Type identifier for vendor |
locationTime | Time of event Occurrence in ms |
odometer | Odometer Reading of the Vehicle in kms |
offset | device timezone offset |
virtualTripEnd | Indicates whether the trip has ended virtually, meaning the system marks the end of the trip without the vehicle physically stopping. |
imei_meid | imei ID |
insideHOO | Indicates if inside hours of operation |
lastKnownLat | Last known latitude in degrees |
storedLocation | Indicates whether the device has stored a location |
| Boolean flag that indicates whether the communication protocol version has changed since the last message (true = changed). |
network3G | Status of 3G Network |
privacyModeEnable | Indicates whether privacy mode is enabled on the device |
prevFuelLevel | The previously recorded fuel level before the current reading in percentage % |
vehicleId | The unique ID of the Vehicle |
userName | Name of the User associated to the device/vehicle |
tripState | Represents the current status of a vehicle's trip, indicating whether the trip is active, completed, or in another state. |
messageTypeId | Type identifier for message |
obdSpeed | OBD device Speed in Kilometers per Hour |
| Current location object of the vehicle |
| Latitude co-ordinate value in degrees |
| Longitude co-ordinate value in degrees |
Updated 2 days ago