Hard Acceleration

The HARD_ACCELERATION_MESSAGE event is used to notify when a vehicle experiences a sudden and rapid increase in speed, indicating hard acceleration. This event helps in identifying unsafe driving behavior.

Event Type: HARD_ACCELERATION_MESSAGE

Trigger Condition

Subscription to the HARD_ACCELERATION_MESSAGE event is mandatory. The event is triggered immediately when a vehicle, already traveling above 3 MPH (Miles Per Hour), accelerates by more than 8 MPH (Miles Per Hour) within one second.

Example Payload

{
"inputBit7": 0,
"partialUpdate": false,
"inputBit4": 0,
"voiceCallActive": 0,
"inputBit3": 0,
"inputBit6": 0,
"inputBit5": 0,
"type": "HARD_ACCELERATION_MESSAGE",
"deviceId": "3f14843e-14c7-11ed-9449-43d7d49f480d",
"networkService": 0,
"finalSpeed": 70,
"commStateConnected": 0,
"messageType": "HARD_ACCELERATION_MESSAGE",
"messageIndex": "10380",
"dimentionFix": 0,
"lastKnownLon": 77.611127,
"inputBit0": 0,
"inputBit2": 0,
"id": "1c00d4da-8801-447e-af2e-dc44c64d156e",
"state": null,
"inputBit1": 0,
"commStatusAvaliable": 0,
"locality": null,
"eventIndex": 0,
"assetNo": "",
"fixStatusCorrected": 0,
"deviceSerial": "3339076777",
"groupName": "Default Group",
"lastKnownTime": 1662629733000,
"jmsType": "",
"vehicleName": "3339076777",
"deviceTypeId": 1,
"destinationQueues": null,
"city": null,
"latitude": 17.691376,
"unitStatus": 0,
"invalidFix": 0,
"dataService": 0,
"noOfAccums": 0,
"customerId": 15047,
"beaconMacAddress": null,
"tripNumber": 33,
"spare": 0,
"address": "115 Evergreen Rd, Sanatoga, PA 19464, USA",
"roaming": 0,
"messageEventType": null,
"stateId": 0,
"updateTime": null,
"userId": "8a938091-8268-7d94-0182-6e50994400ba",
"batteryPercentage": 0,
"currentState": 0,
"deviceProtocolMessageId": null,
"messageEventTypeId": 0,
"zipCode": null,
"country": null,
"deviceAssociatedVIN": "19VDE1F70FE010629",
"beaconType": null,
"groupId": "559d6f4c-11bf-11ed-8895-27b5feb885d3",
"initialSpeed": 50,
"vendorTypeId": 1,
"firmwareVersion": null,
"fixStatuslastKnown": 0,
"fixStatusHistoric": 0,
"longitude": 77.611127,
"satellites": null,
"locationTime": 1662629733000,
"odometer": 9213,
"offset": 360,
"virtualTripEnd": false,
"imei_meid": "3907677739076777",
"insideHOO": true,
"timeOfFix": null,
"sensorNames": null,
"maxAcceleration": 20,
"tripPolyline": null,
"lastKnownLat": 17.691376,
"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,
"vehicleId": "3f14843d-14c7-11ed-9449-2f5611afcf3f",
"lastKnownFixQuality": 0,
"userName": "IronMan",
"tripState": "ACTIVE",
"messageTypeId": 5,
"obdSpeed": null,
"location": {
"latitude": 17.691376,
"longitude": 77.611127
},
"commonState": 0,
"carrierId": null
}

Reference

Field

Description

type
String

Type of event Example: "HARD_ACCELERATION_MESSAGE"

deviceId
String, UUID

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

finalSpeed
Integer

Speed at the moment the hard acceleration event ended in kilometers per hour. Example: 70

initialSpeed
Integer

Speed before the hard acceleration event started in kilometers per hour. started.Example:50

maxAcceleration
Integer

The peak acceleration value detected during the event in km/h² (kilometers per hour per second) Example: 20

messageType
String

Type of message Example: HARD_ACCELERATION_MESSAGE

lastKnownLon
Double

Last known longitude in degrees Example: 77.611127

id
String, UUID

Unique identifier for the event Example: "1c00d95d-3301-4272-b9f6-72a0224bbf9e"

deviceSerial
String

Serial number of the device associated to the vehicle Example: "3339076777"

groupName
String

Name of the group the vehicle belongs to Example: "Default Group"

lastKnownTime
Time Stamp

Last known time in milliseconds Example: 1662630015000

vehicleName
String

Name of the vehicle Example: "3339076777"

deviceTypeId
Integer

Device type identifier, 1-Datalogger Example: 1

city
String

City Name where event occurred Example:san jose

customerId
Integer

The unique Azuga ID of the customer Example: 15047

tripNumber
Integer

Represents a unique ID assigned to a specific trip, allowing the system to track and reference that particular journey or route Example: 33

protocolVersionIdChange
boolean

Indicates if there is change in protocol version id Example: false

privacyModeEnable
Boolean

Indicates if privacy mode is enabled Example: false

vehicleId
String, UUID

Unique identifier for the vehicle Example: "3f14843d-14c7-11ed-9449-2f5611afcf3f"

tripState
String

Represents the current status of a vehicle's trip, indicating whether the trip is active, completed, or in another state. Example: "ACTIVE"

address
String

Example: 115 Evergreen Rd, Sanatoga, PA 19464, USA

userId
String, UUID

Unique identifier for the user
Example: "8a938091-8268-7d94-0182-6e50994400ba"

deviceAssociatedVIN
String

Vehicle Identification Number associated to a device Example: W1W40CHY0MT044280

groupId
String,UUID

Unique identifier for the the group Example: "c337220c-8672-11e2-9b71-55cae3166848"

vendorTypeId
Integer

ID of the Vendor Type Example: 1

locationTime
Time Stamp

Timestamp of location data in milliseconds Example: 1662630309000

odometer
Integer

Odometer reading of vehicle in kilometers Example: 9213

offset
Integer

Device Timezone Offset value Example: -240

virtualTripEnd
Boolean

Indicates if virtual trip ended Example: false

imei_meid
String

Imei ID Example: 2342432423423

insideHOO
Boolean

Indicates if inside hours of operation Example: true

lastKnownLat
Double

Last known latitude in degrees
Example: 17.691376

userName
String

Name of the User associated to the vehicle Example: "IronMan"

obdSpeed
Integer

OBD device Speed in kilometers per hour.

location
Location { latitude: 34.12 longitude: -82.14 }

Current location object of the vehicle

latitude
Double

Latitude co-ordinate value in degrees Example: 34.12

longitude
Double

Longitude co-ordinate value in degrees Example: -82.34

carrierId
Integer

Carrier/Operator the wireless modem is currently using