Расчёт маршрута и времени прибытия
Этот API выстраивает маршрут между двумя точками и получает прогноз времени прибытия в зависимости от выбранного типа транспорта.
Как получить данные
Метод
GET
Адрес запроса
Для выполнения запроса используйте адрес: https://<server_address>/api/api.php?
Параметры запроса
-
cmd = route — команда для построения маршрута
-
mode — тип транспорта, один из:
-
bicycle — велосипед
-
bus — автобус
-
car — машина
-
pedestrian — пешеход
-
scooter — скутер
-
taxi — такси
-
truck — грузовой транспорт
-
origin — координаты точки отправления (lat,long)
-
destination — координаты точки прибытия (lat,long)
-
node — номер узла, на котором нужно выполнить команду
Пример запроса
https://<server_address>/api/api.php?cmd=route&mode=bus&origin=47.211908,39.613767&destination=47.201699,39.668183&node=1
|
Ответ
{
"code": 0,
"data": {
"routes": [
{
"id": "79de74af-5040-441a-ab7a-62d3d9f7a4b4",
"sections": [
{
"id": "2cc5fff7-fd4f-43ac-bcda-00d662207c63",
"type": "vehicle",
"departure": {
"time": "2023-02-22T09:40:07+03:00",
"place": {
"type": "place",
"location": {
"lat": 47.2119,
"long": 39.61372
},
"originalLocation": {
"lat": 47.211908,
"long": 39.613767
}
}
},
"arrival": {
"time": "2023-02-22T09:52:32+03:00",
"place": {
"type": "place",
"location": {
"lat": 47.2017113,
"long": 39.668221
},
"originalLocation": {
"lat": 47.201699,
"long": 39.668183
}
}
},
"summary": {
"duration": 745,
"length": 5452,
"baseDuration": 530
},
"transport": {
"mode": "bus"
}
}
]
}
]
}
}
|
В ответ на API-запрос возвращается:
-
code — код результата (0 = успех)
-
routes — список построенных маршрутов
-
sections — сегменты маршрута с данными:
-
departure / arrival — время и координаты начала и конца маршрута
-
summary — информация о длительности и длине маршрута
-
transport.mode — выбранный тип транспорта