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 |
Updated 7 months ago
Did this page help you?

