Object live events
This API returns real-time events (live events) for vehicles, including contract info, company, driver, speed, and event start location.
How to get data
Method
GET
Request address
To get the data, use the address: https://<server_address>/api/api.php?
Request parameters
-
cmd=live_events — command to get live events
-
node — node number where the command should be executed
Example request
https://<server_address>/api/api.php?cmd=live_events&node=1
|
Response
{
"1264": {
"Contract Number": "CONTRACT ID",
"Company Name": "Al Turki Enterprises",
"Base Location": "LEK",
"Vehicle Owner": "SUB-CONTRACTOR",
"ID": 1680881937,
"EventID, EventType": 0,
"VehicleID": "5174 WA",
"Asset Category": "Light",
"Road Type": "Blacktop",
"DriverID": 18262972,
"Event Start Time": "1680881932",
"Event Start Speed": 0,
"Event Start Location": {
"lat": "18.185841",
"lon": "55.213230"
}
},
"1123": {
"Contract Number": "",
"Company Name": "Al Turki Enterprises",
"Base Location": "",
"Vehicle Owner": "",
"ID": 1680881937,
"EventID, EventType": 0,
"VehicleID": "6076MB",
"Asset Category": "Light",
"Road Type": "Blacktop",
"DriverID": 0,
"Event Start Time": "1680881413",
"Event Start Speed": 0,
"Event Start Location": {
"lat": "18.188658",
"lon": "55.206314"
}
}
}
|
In response to the API request, the following is returned:
-
Object Key (e.g., 1264, 1123) — unique event identifier
-
Contract Number — contract number
-
Company Name — company name
-
Base Location — vehicle base location
-
Vehicle Owner — vehicle owner
-
ID — internal event ID
-
EventID, EventType — event identifier and type
-
VehicleID — vehicle number or ID
-
Asset Category — vehicle category
-
Road Type — type of road
-
DriverID — driver ID
-
Event Start Time — event start time (Unix timestamp)
-
Event Start Speed — speed at event start
-
Event Start Location — coordinates of event start (lat, lon)