Vehicle Not Tracking

The VEHICLE_NOT_TRACKING event is used to notify when a vehicle stops transmitting valid location or tracking data. This helps identify vehicles that are temporarily disconnected or experiencing communication issues.

****Event Type:**VEHICLE_NOT_TRACKING

Trigger Condition

Subscription to the VEHICLE_NOT_TRACKING event is mandatory. The event is triggered when the system detects that a vehicle is no longer reporting tracking data for a defined period of time.

Example Payload

{
"inputBit7": 0,
"partialUpdate": false,
"highEngineSpeed": null,
"inputBit4": 0,
"voiceCallActive": 0,
"inputBit3": 0,
"inputBit6": 0,
"inputBit5": 0,
"type": "GPS_MESSAGE",
"deviceId": "3f14843e-14c7-11ed-9449-43d7d49f480d",
"lowOilPressure": false,
"networkService": 0,
"airFilterClog": false,
"commStateConnected": 0,
"messageType": "VEHICLE_NOT_TRACKING",
"messageIndex": null,
"dimentionFix": 0,
"lastKnownLon": 0,
"inputBit0": 0,
"inputBit2": 0,
"id": "1c006cd2-b600-45eb-93c5-3860974d89b5",
"state": null,
"inputBit1": 0,
"commStatusAvaliable": 0,
"locality": null,
"eventIndex": 0,
"assetNo": null,
"fixStatusCorrected": 0,
"deviceSerial": null,
"groupName": "Default Group",
"deviceAvgSpeed": 0,
"lastKnownTime": null,
"analog3": null,
"analog2": null,
"digital6": null,
"jmsType": "",
"temperAlert": false,
"vehicleName": "3339076777",
"deviceTypeId": 0,
"destinationQueues": null,
"city": null,
"latitude": null,
"tripDistance": 0,
"unitStatus": 0,
"invalidFix": 0,
"dataService": 0,
"noOfAccums": 0,
"satelliteCount": 0,
"highEngineTemperature": null,
"deviceMaxSpeed": 0,
"customerId": 15047,
"beaconMacAddress": null,
"course": 0,
"tripNumber": 0,
"spare": 10,
"address": null,
"roaming": 0,
"needHelp": false,
"messageEventType": null,
"heading": null,
"tripIdlingTime": 0,
"signalStrength": null,
"stateId": 0,
"updateTime": null,
"userId": "8a938091-8268-7d94-0182-6e50994400ba",
"eventCode": 0,
"triggerReason": null,
"batteryPercentage": 0,
"currentState": 0,
"deviceProtocolMessageId": null,
"messageEventTypeId": 0,
"zipCode": null,
"country": null,
"deviceAssociatedVIN": null,
"beaconType": null,
"groupId": "559d6f4c-11bf-11ed-8895-27b5feb885d3",
"batteryNotCharging": false,
"vendorTypeId": 0,
"breakDown": false,
"clutchOverride": false,
"firmwareVersion": null,
"fixStatuslastKnown": 0,
"fixStatusHistoric": 0,
"longitude": null,
"satellites": null,
"locationTime": 1663857611283,
"odometer": 0,
"offset": 0,
"virtualTripEnd": false,
"imei_meid": null,
"insideHOO": true,
"dilution": 0,
"timeOfFix": null,
"sensorNames": null,
"tripPolyline": null,
"lastKnownLat": 0,
"fixQuality": 0,
"unitStatusBit0": 0,
"altitude": 0,
"unitStatusBit2": 0,
"unitStatusBit1": 0,
"unitStatusBit3": 0,
"storedLocation": false,
"protocolVersionIdChange": false,
"accumesList": null,
"accumulators": null,
"batteryDisonnected": false,
"speed": 0,
"deviceSpeed": 0,
"fixStatusPredict": 0,
"network3G": 0,
"lastKnownAddress": null,
"privacyModeEnable": false,
"fixStatus": 0,
"vehicleId": "3f14843d-14c7-11ed-9449-2f5611afcf3f",
"lastKnownFixQuality": 0,
"userName": "3339076777",
"hdop": null,
"tripState": null,
"vehicleOdometer": false,
"messageTypeId": 0,
"obdSpeed": null,
"location": {
"latitude": 17.69191,
"longitude": 77.57724
},
"commonState": 0,
"carrierId": null
}

Reference

Key

Description

highEngineSpeed
Integer / Null

High engine speed value in kmph.
Example: null

type
String

Message type.
Example: "GPS_MESSAGE"

deviceId
String,UUID

Unique identifier of the device.
Example: "3f14843e-14c7-11ed-9449-43d7d49f480d"

lowOilPressure
Boolean

Oil pressure alert.
Example: false

airFilterClog
Boolean

Air filter clog alert.
Example: false

messageType
String

Specific message type.
Example: "VEHICLE_NOT_TRACKING"

lastKnownLon
Double

Last known longitude in degrees.
Example: 0

id
String,UUID

Unique event ID.
Example: "1c006cd2-b600-45eb-93c5-3860974d89b5"

state
String / Null

Vehicle state if available.
Example: null

locality
String / Null

Locality info.
Example: null

assetNo
String / Null

Asset number if any.
Example: null

deviceSerial
String / Null

Device serial number.
Example: null

groupName
String

Group name.
Example: "Default Group"

deviceAvgSpeed
Integer

Average speed of device.
Example: 0

lastKnownTime
Long / Null

Last known timestamp.
Example: null

analog3
Integer / Null

Analog sensor 3.
Example: null

analog2
Integer / Null

Analog sensor 2.
Example: null

digital6
Integer / Null

Digital input 6 status.
Example: null

temperAlert
Boolean

Temperature alert flag.
Example: false

vehicleName
String

Vehicle name.
Example: "3339076777"

deviceTypeId
Integer

Type of device.
Example: 0

city
String / Null

City name.
Example: null

tripDistance
Integer

Trip distance covered.
Example: 0

satelliteCount
Integer

Satellite count at fix.
Example: 0

highEngineTemperature
Integer / Null

High engine temperature.
Example: null

deviceMaxSpeed
Integer

Max speed of device in kmph.
Example: 0

customerId
Integer

Customer ID.
Example: 15047

tripNumber
Integer

Trip number.
Example: 0

spare
Integer

Spare/reserved field.
Example: 10

address
String / Null

Address info.
Example: null

roaming
Integer

Roaming status.
Example: 0

needHelp
Boolean

SOS/Help flag.
Example: false

messageEventType
String / Null

Type of message event.
Example: null

heading
Integer / Null

Heading direction.
Example: null

tripIdlingTime
Integer

Trip idling time in seconds.
Example: 0

updateTime
Long / Null

Update timestamp.
Example: null

userId
String,UUID

User ID.
Example: "8a938091-8268-7d94-0182-6e50994400ba"

triggerReason
String / Null

Reason for trigger.
Example: null

batteryPercentage
Integer

Battery percentage.
Example: 0

currentState
Integer

Current state of device.
Example: 0

deviceProtocolMessageId
String / Null

Device protocol message ID.
Example: null

messageEventTypeId
Integer

Message event type ID.
Example: 0

zipCode
String / Null

Zip code.
Example: null

country
String / Null

Country info.
Example: null

deviceAssociatedVIN
String / Null

VIN associated with device.
Example: null

beaconType
String / Null

Type of beacon.
Example: null

groupId
String,UUID

Group ID.
Example: "559d6f4c-11bf-11ed-8895-27b5feb885d3"

batteryNotCharging
Boolean

Battery charging flag.
Example: false

vendorTypeId
Integer

Vendor-specific type ID.
Example: 0

breakDown
Boolean

Breakdown flag.
Example: false

clutchOverride
Boolean

Clutch override flag.
Example: false

firmwareVersion
String / Null

Firmware version.
Example: null

fixStatuslastKnown
Integer

Last known GPS fix status.
Example: 0

fixStatusHistoric
Integer

Historic GPS fix status.
Example: 0

satellites
Integer / Null

Satellite info.
Example: null

locationTime
Long

Location timestamp (epoch ms).
Example: 1663857611283

odometer
Integer

Odometer reading.
Example: 0

offset
Integer

Offset value.
Example: 0

virtualTripEnd
Boolean

Indicates virtual trip end.
Example: false

imei_meid
String / Null

IMEI/MEID of device.
Example: null

insideHOO
Boolean

Inside Hours of Operation.
Example: true

dilution
Integer

Dilution of precision.
Example: 0

timeOfFix
Long / Null

Time of GPS fix.
Example: null

sensorNames
String / Null

Sensor names.
Example: null

tripPolyline
String / Null

Trip polyline data.
Example: null

lastKnownLat
Double

Last known latitude in degrees.
Example: 0

altitude
Integer

Altitude in meters.
Example: 0

protocolVersionIdChange
Boolean

Protocol version ID change flag.
Example: false

batteryDisonnected
Boolean

Battery disconnected flag.
Example: false

speed
Integer

Speed value in kmph.
Example: 0

deviceSpeed
Integer

Device speed value in kmph.
Example: 0

lastKnownAddress
String / Null

Last known address.
Example: null

privacyModeEnable
Boolean

Privacy mode flag.
Example: false

vehicleId
String,UUID

Vehicle ID.
Example: "3f14843d-14c7-11ed-9449-2f5611afcf3f"

userName
String

User or vehicle name.
Example: "3339076777"

hdop
Integer / Null

Horizontal dilution of precision.
Example: null

tripState
String / Null

Trip state.
Example: null

vehicleOdometer
Boolean

Vehicle odometer flag.
Example: false

messageTypeId
Integer

Message type ID.
Example: 0

obdSpeed
Integer / Null

OBD speed value in kmph.
Example: null

location
Location { latitude: 34.12 longitude: -82.14 }

Current location object of the vehicle

latitude
Double

Latitude co-ordinate value in degrees Example: 17.696502

longitude
Double

Longitude co-ordinate value in degrees Example: 77.565824