Работа с одобренными треками

Этот API помогает работать с утверждёнными треками транспортных средств: устанавливать периоды, получать треки и использовать трек-плеер.

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

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

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

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

Параметры передаются через строку запроса методом POST или GET, в зависимости от команды.
Чтобы получить нужные данные, добавьте к адресу запроса параметры. Параметры указываются после знака вопроса «?» и разделяются знаком «&».
  • cmd=set_approved_tracks — команда для установки утверждённых периодов
  • cmd=get_approved_tracks — команда для получения одобренных треков
  • veh — государственный номер или идентификатор транспортного средства
  • ts — начало периода (timestamp)
  • te — конец периода (timestamp)
  • node — номер узла, на котором нужно выполнить команду
     

Установить утверждённые периоды

Пример API-запроса
https://<server_address>/api/api.php?cmd=set_approved_tracks&veh=Р852ОВ77&ts=1537945200&te=1537952400&node=1
Ответ на API
{"code":0,"msg":"ОК обновлено"}
 

Получить одобренные треки

Пример API-запроса
http://<admin_address>/api/api.php?cmd=get_approved_tracks&veh=Р852ОВ77&ts=1537945200&te=153795 2400&node=1
Ответ на API
{
  "code":0,
  "data":{
    "approved":[
      {"length":2.8051348330013,"ts":1537948809,"te":1537949431,"max_speed":"59","avg_speed":26}
    ],
    "not_approved":[
      {"length":1.8650025635569,"ts":1537945206,"te":1537946030,"max_speed":"40","avg_speed":12},
      {"length":4.1987356239849,"ts":1537948298,"te":1537948798,"max_speed":"65","avg_speed":37}
    ]
  }
}
В ответ на API-запрос возвращается:
  • approved— список утверждённых треков
  • not_approved— список треков, которые не были утверждены
  • length— длина трека в километрах
  • ts— время начала трека (timestamp)
  • te— время конца трека (timestamp)
  • max_speed— максимальная скорость на треке
  • avg_speed— средняя скорость
 

Трек-плеер

Трек-плеер — это веб-сервис, который позволяет визуально просматривать треки транспорта. В отличие от обычного API, он сразу возвращает готовую страницу с картой и треком, а не JSON или XML.
Ссылка для просмотра трека:
http://<server_address>/api/track_player.php?login=demo&pass=demo&ts=1536933600&te=1536940800&veh=в848ае199&lang=ru&node=1
Вы можете использовать URL как iframe src для отображения трека на странице.