Получение последнего события транспортного средства

API предназначен для получения последнего события транспортного средства за предыдущие 24 часа.
Метод поддерживает сопоставление аккаунтов: пользователь может получить событие транспортного средства из связанного аккаунта, если у него есть доступ к этому транспортному средству.

Как получить данные

Метод

GET

Адрес запроса

Для получения данных используйте адрес:
https://<server_address>/api/v3/events/live
Замените <server_address> адресом сервера PILOT.

Параметры запроса

Добавьте к адресу запроса параметр:
  • agent_id — идентификатор транспортного средства в PILOT.
Транспортное средство должно быть доступно авторизованному пользователю.
 

Пример запроса

GET https://<server_address>/api/v3/events/live?agent_id=2000
Authorization: Bearer <token>
X-Node: 0

Ответ

{
  "code": 0,
  "msg": "OK",
  "events": [
    {
      "Cotract Number": 1102,
      "Company Name": "Boooch Test",
      "AgentId": 2000,
      "VehicleID": "10-14262 Sunny",
      "Road Type": "Blacktop",
      "EventID": 4531206,
      "Event Type": 103,
      "Event Message": "SpeedN|110|>|112|10|ss|17",
      "Event Start Time": 1785746496,
      "Event Start Speed": null,
      "Event Start location": {
        "lat": "25.164997",
        "lon": "55.235535"
      },
      "Event End Time": null,
      "Event duration": null
    }
  ],
  "process_time": 0.0222
}
В ответ на API-запрос возвращается:
  • code — код выполнения запроса. Значение 0 означает успешное выполнение
  • msg — результат выполнения запроса
  • events — массив найденных событий
  • process_time — время обработки запроса в секундах
Массив events содержит:
  • Cotract Number — идентификатор аккаунта, которому принадлежит транспортное средство
  • Company Name — название аккаунта
  • AgentId — идентификатор транспортного средства в PILOT
  • VehicleID — название транспортного средства
  • Road Type — тип дорожного покрытия. В текущей версии возвращается Blacktop
  • EventID — идентификатор события
  • Event Type — тип события
  • Event Message — текст события
  • Event Start Time — время начала события в формате Unix timestamp
  • Event Start Speed — скорость в момент начала события. Если данные отсутствуют, возвращается null
  • Event Start location — координаты транспортного средства в момент начала события:
  • lat — широта
  • lon — долгота
  • Event End Time — время завершения события в формате Unix timestamp. Если данные отсутствуют, возвращается null
  • Event duration — продолжительность события в секундах. Рассчитывается как разница между временем завершения и временем начала события. Если одно из значений отсутствует, возвращается null