Posted Over speeding Event

The POSTED_OVERSPEEDING_EVENT is triggered when a vehicle exceeds the posted speed limit, generating an overspeeding event based on the device’s real-time data.

**Event Name:**POSTED_OVERSPEEDING_EVENT

**Enablement Package:speed safe


Trigger Condition

  • The speed safe package must be subscribed for the account.
  • The POSTED_OVERSPEEDING_EVENT webhook must be subscribed.
  • The event is triggered when the vehicle exceeds the designated road speed limit.

Example Payload

{
  "inputBit7": 0,
  "partialUpdate": false,
  "overSpeedType": 1,
  "postedSpeedLimit": 50,
  "inputBit4": 0,
  "voiceCallActive": 0,
  "inputBit3": 0,
  "inputBit6": 0,
  "groupId": "3880126e-12b4-11e7-838e-c5e8230b9f06",
  "inputBit5": 0,
  "type": "OVER_SPEEDING_MESSAGE",
  "deviceId": "d1cc0276-bbd9-11ef-ae7a-2708d57122d0",
  "networkService": 0,
  "commStateConnected": 0,
  "messageType": "POSTED_OVERSPEEDING_EVENT",
  "minSpeedingDurationInSec": 0,
  "dimentionFix": 0,
  "lastKnownLon": 0,
  "pslByPercentageValue": 0,
  "inputBit0": 0,
  "vendorTypeId": 0,
  "overSpeedingStartSpeed": 0,
  "inputBit2": 0,
  "id": "2500c41b-e600-45cb-af18-a1ae499b17da",
  "inputBit1": 0,
  "fixStatuslastKnown": 0,
  "fixStatusHistoric": 0,
  "serialNumber": "1714165672",
  "commStatusAvaliable": 0,
  "locationTime": 1737957237000,
  "odometer": 0,
  "offset": 0,
  "overSpeedingDuration": 0,
  "virtualTripEnd": false,
  "eventIndex": 0,
  "fixStatusCorrected": 0,
  "startOdometer": 0,
  "exceedsByUnit": "SPEED",
  "insideHOO": true,
  "deviceSerial": "1714165672",
  "groupName": "Default Group",
  "lastKnownLat": 0,
  "fixQuality": 0,
  "unitStatusBit0": 0,
  "vehicleName": "1714165672",
  "unitStatusBit2": 0,
  "deviceTypeId": 0,
  "unitStatusBit1": 0,
  "distance": 0,
  "unitStatusBit3": 0,
  "storedLocation": false,
  "protocolVersionIdChange": false,
  "peakSpeed": 0,
  "unitStatus": 0,
  "deviceSpeed": 150,
  "fixStatusPredict": 0,
  "invalidFix": 0,
  "dataService": 0,
  "network3G": 0,
  "noOfAccums": 0,
  "privacyModeEnable": false,
  "customerId": 5034,
  "fixStatus": 0,
  "vehicleId": "d1cc0275-bbd9-11ef-ae7a-3f5871b7a218",
  "tripNumber": 0,
  "lastKnownFixQuality": 0,
  "spare": 0,
  "roaming": 0,
  "messageEventType": "GPS_MESSAGE",
  "stateId": 0,
  "averageSpeed": 0,
  "userName": "1714165672 .",
  "userId"": "d1e508b7-bbd9-11ef-ae7a-a76e6b156609",
  "allowedExcessSpeedLimit": 0,
  "messageTypeId": 0,
  "location": {
    "latitude": 17.259605,
    "longitude": 78.383938
  },
  "batteryPercentage": 0,
  "commonState": 0,
  "currentState": 0,
  "messageEventTypeId": 0
}

Reference

Field

Description

overSpeedType*
Integer

Indicates the kind of overspeeding. Example: 1 (1 = standard overspeed)

postedSpeedLimit*
Integer

The legal speed limit at the location (in mph or km/h depending on your account settings). Example: 50

groupId*
String

ID of the group the vehicle belongs to. Example: 3880126e-12b4-11e7-838e-c5e8230b9f06

type*
String

Sub-type of event. Example: OVER_SPEEDING_MESSAGE

deviceId*
String

Internal unique ID of the tracking device. Example: d1cc0276-bbd9-11ef-ae7a-2708d57122d0

messageType*
String

Event type (Identifies that this alert is related to speeding). Example: POSTED_OVERSPEEDING_EVENT

id*
String

Unique ID for this overspeeding event. Example: "2500c41b-e600-45cb-af18-a1ae499b17da"

locationTime*
Integer

Time when the speeding event occurred. Convert to human readable format (YYYY-MM-DD HH:mm:ss UTC). Example: 1737957237000

odometer*
Integer

Vehicle odometer reading at the time of event (meters or miles depending on settings). Example: 0

overSpeedingDuration*
Integer

Total duration the vehicle was speeding (seconds). Example: 0

exceedsByUnit*
String

Indicates the measurement type. Example: "SPEED".

deviceSerial*
String, UUID

Manufacturer serial number of the device. Example: "1714165672"

groupName*
String

Name of the group. Example: Default Group

vehicleName*
String

Vehicle name/label shown in your fleet. Example: 1714165672

peakSpeed*
Integer

Highest speed reached during the event (mph or km/h). Example: 0

deviceSpeed*
Integer

Actual recorded speed of the vehicle at the time of the event (mph or km/h). Example: 150

customerId*
Integer

Customer account ID. Example: 5034

vehicleId*
String

Vehicle’s unique system ID. Example: d1cc0275-bbd9-11ef-ae7a-3f5871b7a218

messageEventType*
String

Category of message. Generally "GPS_MESSAGE" since location is involved.

averageSpeed*
Integer

Average speed during the overspeeding period (mph or km/h).
Example: 0

userName*
String

Driver or user name displayed. Example: "1714165672"

userId*
String

ID of the assigned driver/user at the time of event. Example: d1e508b7-bbd9-11ef-ae7a-a76e6b156609

allowedExcessSpeedLimit*
Integer

Buffer above the legal speed limit before triggering alert (mph or km/h).
Example: 0 (no buffer).

latitude*
Integer

Latitude where overspeeding occurred (decimal degrees). Example: 17.259605

longitude*
Integer

Longitude where overspeeding occurred (decimal degrees). Example: 78.383938