Posted Speed Alert
This POSTED_SPEED_ALERT webhook event is triggered when a vehicle exceeds the posted speed limit as defined by the alert configuration.
**Event Name:**POSTED_SPEED_ALERT
**Enablement Package:speed safe
Trigger Condition
- The speed safe package must be subscribed.
- The POSTED_SPEED_ALERT webhook event must be subscribed.
- The event is triggered when the road speed limit is exceeded.
Example Payload
{
"alertTypeId": 15,
"postedSpeedLimit": 88,
"deviceTypeId": 1,
"vehicleName": "GMC 2500 - Water Truck",
"latitude": 44.0391247,
"groupId": "ce15650e-401a-11ee-8206-5bb9ea9323e1",
"alertConfigValue": "POSTED_SPEED_DURATION:0,POSTED_SPEED_EXCEEDS_BY:24.150000000000002,POSTED_SPEED_EXCEEDS_BY_UNIT:SPEED",
"peakSpeed": 0,
"deviceId": "ce158d78-40d3-11ee-9aea-2d457595478c",
"speed": 120,
"initialSpeed": 0,
"duration": 0,
"finalSpeed": 0,
"messageType": "POSTED_SPEED_ALERT",
"alertName": "PSL over 15",
"customerId": 23041,
"eventTime": 1732112955000,
"id": "a904fb9a-d0ef-40de-83bb-5a6f480b3316",
"vehicleId": "ce158d77-40d3-11ee-9aea-17b4742747e3",
"alertId": "8fa68992-87cf-11ee-8710-8924622adabf",
"longitude": -85.1597414,
"settings": {
"POSTED_SPEED_DURATION": "0",
"POSTED_SPEED_EXCEEDS_BY_UNIT": "SPEED",
"POSTED_SPEED_EXCEEDS_BY": "24.150000000000002"
},
"address": "15651 M-115, Marion, MI 49665, USA",
"offset": 0,
"averagePostedSpeedLimit": 0,
"averageSpeed": 0,
"firstPostedSpeedLimit": 0,
"userName": "",
"deviceSerialNumber": "9902304101",
"groupName": "Default Group",
"location": {
"latitude": 44.0391247,
"longitude": -85.1597414
},
"pslStartTime": 1732112955000
}Reference
Field | Description |
|---|---|
alertTypeId* | Numeric identifier for the alert type.
Example: |
postedSpeedLimit* | Speed limit at the location where the alert triggered in (km/h or mph). Example: |
deviceTypeId* | Device model/type identifier.
Example: |
vehicleName* | The vehicle’s assigned display name.
Example: |
latitude* | Latitude of the alert location in decimal degrees.
Example: |
groupId* | Group ID where vehicle belongs. |
deviceId* | Unique ID of the device installed in the vehicle.
Example: |
speed* | Actual measured speed at alert time → km/h or mph (based on customer settings).
Example: |
initialSpeed* | Speed when the violation first began in km/h or mph. Example:0 |
finalSpeed* | Speed when the violation ended in km/h or mph. Example:0 |
averageSpeed* | Average posted speed limit across the violation period in km/h or mph.Example:0 |
messageType* | Identifies the event type.
Example: |
alertName* | Name of the alert as configured by the user/admin.
Example: |
customerId* | Customer account ID. |
eventTime* | Timestamp when the alert was generated → Epoch (ms) → convert to YYYY-MM-DD HH:MM:SS in driver’s timezone.
Example: |
id* | Unique ID for this specific alert occurrence.
Example: |
vehicleId* | Unique ID of the vehicle generating the alert.
Example: |
alertId* | Unique ID associated with the alert configuration.
Example: |
longitude* | Longitude of the alert location in decimal degrees.
Example: |
POSTED_SPEED_DURATION* | Allowed threshold above posted speed limit (km/h or mph). Example: |
POSTED_SPEED_EXCEEDS_BY_UNIT* | Unit of measurement always SPEED. |
POSTED_SPEED_EXCEEDS_BY* | Minimum required violation duration in seconds (sec).
Example: |
address* | Human-readable physical address resolved from the coordinates. Example: |
offset* | Driver’s timezone offset in minutes. Example: 0 |
averagePostedSpeedLimit* | Average posted speed limit across the violation period in km/h or mph. Example: 0 |
averageSpeed* | Average speed throughout the alert window → km/h or mph. Example:0 |
firstPostedSpeedLimit* | First PSL value detected during the violation window in km/h or mph. Example:0 |
userName* | Name of the driver/user associated with the vehicle. |
deviceSerialNumber* | Serial number of the tracking device.
Example: |
groupName* | Name of the group the vehicle belongs to.
Example: |
pslStartTime* | Time when PSL violation started.
Example: |
Updated 5 days ago
