Расчёт маршрута и времени прибытия

Этот 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 — выбранный тип транспорта