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 | Identifies the webhook event type.
Example: |
deviceId* | Unique ID of the onboard tracking device.
Example: |
messageType* | Type of message. |
messageIndex_* | Message sequence index. |
id* | Unique ID generated for this overspeeding event.
Example: |
overSpeedingDuration* | Duration of overspeeding violation in seconds (sec). Example:0 |
deviceSerial* | Serial number printed on the device hardware.
Example: |
groupName* | Name of the group. Example: `"Default Group" |
vehicleName* | Vehicle display name or serial.
Example: |
customerId* | Unique identifier for customer. |
userId* | Unique identifier of the user.
Example: |
allowedExcessSpeedLimit* | Allowed margin above posted speed (if configured) in km/h or mph. Example: 0. |
overSpeedType* | Type of overspeed. Example: 1 (1 = manual speed limit). |
postedSpeedLimit_* | Legal/posted speed limit of the road at event location in km/h or mph (based on customer settings). Example: "100" |
groupId* | Group identifier for vehicle grouping. Example: `559d6f4c-11bf-11ed-8895-27b5feb885d3 |
offset* | Time when the device recorded the location fix in Epoch (ms) → convert to YYYY-MM-DD HH:MM:SS.
Example: |
locationTime* | Timezone offset (in minutes) used for local time conversion. Example:0. |
exceedsByUnit* | Unit for excess speed threshold → Always SPEED. |
peakSpeed* | Maximum speed recorded during the event → km/h or mph.
Example: |
averageSpeed* | Average speed across event window in km/h or mph. Example: `0 |
deviceSpeed* | Actual speed recorded at the moment → km/h or mph.
Example: |
vehicleId* | Unique ID of the vehicle.
Example: |
userName* | User/driver name associated.
Example: |
latitude* | Actual latitude where event occurred in decimal degrees.
Example: |
longitude* | Actual longitude where event occurred in decimal degrees.
Example: |
Updated 4 days ago
