Отчёт по движению

С помощью этого API получайте  информацию о поездках транспортного средства за выбранный период. При включении модуля «Геозоны», каждая поездка разбивается на отрезки по входу и выходу из зон.

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

Метод

GET

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

Для получения данных используйте адрес: https://<server_address>/api/api.php?
Параметры запроса
  • cmd=run — команда для получения отчёта
  • imei — уникальный идентификатор объекта (ТС)
  • start — время начала выборки в формате Unix timestamp
  • stop — время окончания выборки в формате Unix timestamp
  • zones — включение информации о геозонах:
    — 0 — треки включаются целиком, без разбивки по зонам
    — 1 — треки разбиваются на отрезки по моментам входа и выхода в геозоны
  • eco— включение данных эко-драйвинга в треки
  • node — номер узла, на котором нужно выполнить команду
 

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

https://<server_address>/api/api.php?cmd=run&imei=359772039289781&start=1406318400&stop=1406404800&zones=1&node=1
Ответ
{
   "code": 0,
   "msg": "OK",
   "zones": {
       "1406341994": {
           "ts": 1406341994,
           "stopuid": "213854753412306",
           "stopname": "Гараж",
           "lat": "53.3861",
           "lon": "83.7127",
           "msgtype": 2
       },
       "1406353422": {
           "ts": 1406353422,
           "stopuid": "966971618589014",
           "stopname": "Барнаульский автовокзал",
           "lat": "53.3508",
           "lon": "83.7593",
           "msgtype": 1
       }
   },
   "tracks": {
       "1406341955": {
           "ts": 1406341955,
           "te": 1406341994,
           "length": 0.26,
           "maxspeed": "17",
           "avgspeed": 17
       },
       "1406341994": {
           "ts": 1406341994,
           "te": 1406353389,
           "length": 119.83,
           "maxspeed": "96",
           "avgspeed": 58
       }
   }
}
В ответ на API-запрос возвращается:
Массив зон (zones) — точки входа и выхода из геозон:
  • ts — время события (Unix timestamp)
  • stopuid — уникальный идентификатор геозоны
  • stopname — название геозоны
  • lat — широта точки
  • lon — долгота точки
  • msgtype — тип события (1 = вход, 2 = выход)
Массив треков (tracks) — информация о поездках:
  • ts — время начала поездки (Unix timestamp)
  • te — время окончания поездки (Unix timestamp)
  • length — длина поездки в километрах
  • maxspeed — максимальная скорость (км/ч)
  • avgspeed — средняя скорость (км/ч)
  • lats — широта точки старта
  • lons — долгота точки старта
  • late — широта точки окончания
  • lone — долгота точки окончания
  • eco — данные эко-драйвинга (при включении параметра eco):
  • Acceleration, Braking, Speed — показатели по каждому параметру