Статистика поездок и пройденное расстояние

Этот API получает информацию о пробеге, поездках и парковках транспортного средства за указанный период.

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

Метод

GET

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

Для получения данных используйте адрес:  https://<server_address>/api/api.php?

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

  • cmd = distance — команда для получения данных о пробеге
  • imei — уникальный идентификатор объекта
  • start — время начала выборки (Unix timestamp)
  • stop — время окончания выборки (Unix timestamp)
  • node — номер узла, на котором нужно выполнить команду
 

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

https://<server_address>/api/api.php?cmd=distance&imei=7157153151020&start=1676926800&stop=1677013200&node=1
Ответ
{
  "code":0,
  "msg":"OK",
  "distance":{
    "duration":48513,
    "length":637.3039,
    "parking_time":11548,
    "parking_count":11,
    "max_speed":96,
    "avg_speed":66,
    "trips_cnt":1,
    "trips_ts":1676964676,
    "trips_te":1677013189,
    "parkings":[
      {"agent_id":36830,"ts":1676964691,"te":1676965159,"lat":"59.807117","lon":"30.16806","length":"0.055916477"},
      {"agent_id":36830,"ts":1676965990,"te":1676966589,"lat":"59.808876","lon":"30.167131","length":"6.7342625"}
    ],
    "tracks":[],
    "trips_time":48513,
    "trips_driving":36965,
    "startlat":"59.806779",
    "startlon":"30.167737",
    "stoplat":"56.258973",
    "stoplon":"36.862156"
  }
}
В ответ на API-запрос возвращается:
  • code — код результата (0 — успех)
  • msg — сообщение сервера
  • distance — объект с данными о поездках и пробеге:
  • length — реальный пробег (км)
  • duration — длительность пробега от начала первой поездки до окончания последней (сек)
  • trips_cnt — количество поездок
  • trips_ts — время начала первой поездки (Unix timestamp)
  • trips_te — время окончания последней поездки (Unix timestamp)
  • trips_time — суммарное время поездок (сек)
  • trips_driving — время движения, когда машина ехала без остановок (сек)
  • max_speed — максимальная скорость (км/ч)
  • avg_speed — средняя скорость (км/ч)
  • parking_count — количество парковок
  • parking_time — суммарное время стоянок (сек)
  • parkings — массив парковок с деталями:
  • agent_id — идентификатор агента
  • ts — время начала парковки
  • te — время окончания парковки
  • lat — широта парковки
  • lon — долгота парковки
  • length — длина парковки (км)
  • tracks — массив треков (по поездкам, если есть)
  • startlat, startlon — координаты начала первой поездки
  • stoplat, stoplon — координаты конца последней поездки