Формат ответа

Ответ API содержит маршрут, разбитый на несколько участков. Каждый участок состоит из нескольких шагов, которые представлены ломаными линиями. Для каждого участка предоставляется информация о качестве дороги и ожидаемом времени на его прохождение.

https://api.routing.yandex.net/v2/route?waypoints=25.234369457896325,55.280222457968712|25.234369457896325,55.401544758961258&apikey=YOUR_API_KEY

В этом случае ответ будет выглядеть следующим образом:

{
  "traffic": "realtime",
  "route": {
    "legs": [
      {
        "status": "OK",
        "steps": [
          {
            "duration": 11.52513027,
            "length": 44.85900116,
            "polyline": {
              "points": [
                [25.229762, 55.289311],
                ...
                [24.994437, 55.130251]
              ]
            },
            "mode": "driving",
            "waiting_duration": 0
          },
          {
            "duration": 206.4788513,
            "length": 1116.158936,
            "polyline": {
              "points": [
                [25.229762, 55.289311],
                ...
                [24.994437, 55.130251]
              ]
            },
            "mode": "driving",
            "waiting_duration": 0
          },
          {
            "duration": 1143.630005,
            "length": 6356.562988,
            "polyline": {
              "points": [
                [25.229762, 55.289311],
                ...
                [24.994437, 55.130251]
              ]
            },
            "mode": "driving",
            "waiting_duration": 0
          },
          {
            "duration": 239.3830109,
            "length": 524.8220825,
            "polyline": {
              "points": [
                [25.229762, 55.289311],
                ...
                [24.994437, 55.130251]
              ]
            },
            "mode": "driving",
            "waiting_duration": 0
          }
        ]
      }
    ],
    "flags": {
      "hasTolls": true,
      "hasNonTransactionalTolls": false 
    }
  }
}

Параметры ответаПараметры ответа

traffic

Тип информации о пробках, который используется при построении маршрута. Возможные значения:

• realtime — используется информация о пробках на момент запроса.
• forecast — используется прогноз пробок на ближайший час.
• disabled — не используется никакая информация о пробках.

route

Информация о построенном маршруте.

legs

Отрезки маршрута между точками, указанными в параметре waypoints.

status

Статус построения маршрута. Возможные значения: OK, FAIL

steps

Шаги, выполнение которых требуется для прохождения отрезка маршрута.

length

Длина шага, в метрах.

duration

Время, необходимое для прохождения шага, в секундах.

waiting_duration

Информация о времени ожидания больше не поддерживается и скоро будет исключена из ответа API. Время ожидания без движения на участке маршрута. Например, учитывается задержка, вызванная ожиданием сведения моста.

mode

Режим маршрутизации. Возможные значения:

• driving — маршрут для легкового автомобиля. Используется по умолчанию;
• truck — маршрут для грузового автомобиля;
• walking — маршрут для пешехода;
• transit — маршрут с использованием общественного транспорта.

polyline

Ломаная линия, составляющая маршрут.

points

Точки, составляющие линию.

Указаны в десятичных градусах (стандарт WGS84). Каждая точка описывается парой координат в следующем формате: <широта,долгота>

flags

Дополнительная информация о построенном маршруте.

hasTolls

Маршрут проходит через платные дороги.

hasNonTransactionalTolls

Маршрут проходит через условно-платные дороги (проезд оплачивается только при определенных условиях).

Сообщения об ошибкахСообщения об ошибках

Если при обработке запроса происходит ошибка, API возвращает сообщение с описанием ошибки в поле errors:

{"errors": ["0: 0: parameter 'waypoints' is missing"]}

{"errors": ["Key not found"]}

{"errors": ["parameter 'apikey' is missing"]}

{"errors": ["Counter total limit exceeded. Limit: XXX, current value: YYY"]}