Posted Speed Limit

The POSTED_SPEED_LIMIT event is triggered when a vehicle exceeds a manually configured speed limit for a specified minimum duration. This speed limit is not derived from the map's posted limit but from the custom overspeed parameters configured by the fleet administrator in the portal.

**Event Name:**POSTED_SPEED_LIMIT

**Enablement Package:speed safe

Trigger Condition

  • The speed safe package must be enabled for the account.
  • The POSTED_SPEED_LIMIT webhook must be subscribed.
  • The event is triggered when the vehicle drives over the road speed limit for the specified amount of time.

Example Payload

{
"inputBit7": 0,
"partialUpdate": false,
"inputBit4": 0,
"voiceCallActive": 0,
"inputBit3": 0,
"inputBit6": 0,
"inputBit5": 0,
"type": "OVER_SPEEDING_MESSAGE",
"deviceId": "e4c97790-14c3-11ed-9449-7dd6059504b4",
"networkService": 0,
"overSpeedingStartCity": null,
"commStateConnected": 0,
"messageType": "POSTED_SPEED_LIMIT",
"messageIndex": null,
"minSpeedingDurationInSec": 0,
"dimentionFix": 0,
"lastKnownLon": 0,
"pslByPercentageValue": 0,
"inputBit0": 0,
"inputBit2": 0,
"id": "1c006a6b-bd01-470f-ab5c-9be56a4bfe0a",
"state": null,
"inputBit1": 0,
"commStatusAvaliable": 0,
"locality": null,
"overSpeedingDuration": 0,
"eventIndex": 0,
"assetNo": null,
"fixStatusCorrected": 0,
"deviceSerial": "9076501020",
"groupName": "Default Group",
"lastKnownTime": null,
"jmsType": "",
"vehicleName": "9076501020",
"deviceTypeId": 0,
"destinationQueues": null,
"city": null,
"latitude": null,
"unitStatus": 0,
"overSpeedingStartZipCode": null,
"invalidFix": 0,
"dataService": 0,
"noOfAccums": 0,
"customerId": 15047,
"beaconMacAddress": null,
"startTime": null,
"tripNumber": 0,
"sensorValue": null,
"overSpeedingStartAddress": null,
"spare": 0,
"address": null,
"roaming": 0,
"messageEventType": null,
"stateId": 0,
"updateTime": null,
"averageSpeed": 0,
"userId": "8a938091-8268-7d94-0182-6e3aa04200b8",
"allowedExcessSpeedLimit": 0,
"batteryPercentage": 0,
"currentState": 0,
"deviceProtocolMessageId": null,
"messageEventTypeId": 0,
"overSpeedingStartCountry": null,
"zipCode": null,
"country": null,
"overSpeedType": 1,
"postedSpeedLimit": 100,
"deviceAssociatedVIN": null,
"beaconType": null,
"groupId": "559d6f4c-11bf-11ed-8895-27b5feb885d3",
"vendorTypeId": 0,
"overSpeedingStartSpeed": 0,
"firmwareVersion": null,
"fixStatuslastKnown": 0,
"fixStatusHistoric": 0,
"longitude": null,
"overSpeedinStartStagingId": null,
"satellites": null,
"locationTime": 1664025063000,
"odometer": 0,
"offset": 0,
"sensorUnitVal": null,
"virtualTripEnd": false,
"imei_meid": null,
"startOdometer": 0,
"exceedsByUnit": "SPEED",
"insideHOO": true,
"eventInfo": null,
"timeOfFix": null,
"sensorNames": null,
"tripPolyline": null,
"lastKnownLat": 0,
"fixQuality": 0,
"unitStatusBit0": 0,
"unitStatusBit2": 0,
"unitStatusBit1": 0,
"distance": 0,
"unitStatusBit3": 0,
"storedLocation": false,
"protocolVersionIdChange": false,
"peakSpeed": 0,
"accumesList": null,
"accumulators": null,
"deviceSpeed": 134,
"overSpeedingStartState": null,
"fixStatusPredict": 0,
"network3G": 0,
"lastKnownAddress": null,
"overSpeedinStartStoreId": null,
"overSpeedingStartLocality": null,
"startLocation": null,
"privacyModeEnable": false,
"fixStatus": 0,
"vehicleId": "e4c9778f-14c3-11ed-9449-17f42fbb1b68",
"lastKnownFixQuality": 0,
"userName": "Shreyas Iyer",
"tripState": null,
"messageTypeId": 0,
"obdSpeed": null,
"location": {
"latitude": 17.561108,
"longitude": 78.375249
},
"commonState": 0,
"carrierId": null
}

Reference

Field

Description

type
String

Identifies the webhook event type. Example: "OVER_SPEEDING_MESSAGE"

deviceId*
String, UUID

Unique ID of the onboard tracking device. Example: "e4c97790-14c3-11ed-9449-7dd6059504b4"

messageType*
String

Type of message.
Example: "POSTED_SPEED_LIMIT"

messageIndex_*
String

Message sequence index.
Example: "Null"

id*
String, UUID

Unique ID generated for this overspeeding event. Example: "1c006a6b-bd01-470f-ab5c-9be56a4bfe0a"

overSpeedingDuration*
Integer

Duration of overspeeding violation in seconds (sec). Example:0

deviceSerial*
String

Serial number printed on the device hardware. Example: "9076501020"

groupName*
String

Name of the group. Example: `"Default Group"

vehicleName*
String

Vehicle display name or serial. Example: "9076501020"

customerId*
Integer

Unique identifier for customer.
Example: 15047

userId*
String, UUID

Unique identifier of the user. Example: "8a938091-8268-7d94-0182-6e3aa04200b8"

allowedExcessSpeedLimit*
Integer

Allowed margin above posted speed (if configured) in km/h or mph. Example: 0.

overSpeedType*
Integer

Type of overspeed. Example: 1 (1 = manual speed limit).

postedSpeedLimit_*
Integer

Legal/posted speed limit of the road at event location in km/h or mph (based on customer settings). Example: "100"

groupId*
Integer

Group identifier for vehicle grouping. Example: `559d6f4c-11bf-11ed-8895-27b5feb885d3

offset*
Integer

Time when the device recorded the location fix in Epoch (ms) → convert to YYYY-MM-DD HH:MM:SS. Example: 1664025063000

locationTime*
Integer

Timezone offset (in minutes) used for local time conversion. Example:0.

exceedsByUnit*
Time Stamp

Unit for excess speed threshold → Always SPEED.

peakSpeed*
Integer

Maximum speed recorded during the event → km/h or mph. Example: 0

averageSpeed*
Integer

Average speed across event window in km/h or mph. Example: `0

deviceSpeed*
Integer

Actual speed recorded at the moment → km/h or mph. Example: 134

vehicleId*
String, UUID

Unique ID of the vehicle. Example: "e4c9778f-14c3-11ed-9449-17f42fbb1b68"

userName*
String

User/driver name associated. Example: "Shreyas Iyer"

latitude*
Double

Actual latitude where event occurred in decimal degrees. Example: 17.561108

longitude*
Double

Actual longitude where event occurred in decimal degrees. Example: 78.375249