Работа с одобренными треками
Этот 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 для отображения трека на странице.