Количество альтернативных маршрутов, которые будут построены в дополнение к основному.

Информация о высоте маршрута и её изменении (если был указан параметр `need_altitudes`)

Суммарное увеличение высоты в см

Суммарное снижение высоты в см

Максимальная высота над уровнем моря в см

Максимальный угол наклона

Минимальная высота над уровнем в см

Ошибка валидации запроса

Название поля с ошибкой

Location

Message

Error Type

Если true, при построении маршрута могут использоваться перекрытые дороги.

Набор исключаемых областей, которые следует избегать при построении маршрута. Не более 25.

Тип движения: <ul type="disk"> <li> `driving` - автомобильный. </li></ul>

Какие точки из массива `points` являются точками отправления (массив индексов)

Дата и время начала движения в формате <a href='https://tools.ietf.org/html/rfc3339#section-5.8' target='_blank'>RFC 3339</a> (например, <i>2020-05-15T15:52:01Z</i>). Если параметр не указан, используется текущее время.

Какие точки из массива `points` являются точками прибытия (массив индексов)

Тип маршрута: <ul type="disk"> <li> `jam` - кратчайший по времени с учётом текущих пробок, </li><li> `statistics` - кратчайший по времени с учётом статистических данных по пробкам, </li><li> `shortest` - кратчайший по расстоянию. </li></ul>

Статус задачи на построение матрицы смежности

Дополнительная информация о статусе задачи

Ссылка на файл с решением

Статус задачи: <ul type="disk"> <li> `TASK_CREATED` - задача создана; </li><li> `TASK_IN_QUEUE` - задача находится в очереди на обработку; </li><li> `TASK_IN_PROGRESS` - задача находится в процессе выполнения; </li><li> `TASK_DONE` - задача успешно завершена; </li><li> `TASK_CANCELED` - задача была отменена. </li></ul>

Идентификатор этажа до маневра (для типов манёвров `indoor_*`)

Название этажа до маневра (для типов манёвров `indoor_*`)

Идентификатор этажа после маневра (для типов манёвров `indoor_*`)

Название этажа после маневра (для типов манёвров `indoor_*`)

Название иконки маневра: <ul type="disk"> <li> `start` - начало движения, </li><li> `finish` - конец движения, </li><li> `crossroad_straight` - движение прямо, </li><li> `crossroad_slightly_left` - плавный поворот налево, </li><li> `crossroad_left` - поворот налево, </li><li> `crossroad_sharply_left` - крутой поворот налево, </li><li> `crossroad_sharply_right` - крутой поворот направо, </li><li> `crossroad_right` - поворот направо, </li><li> `crossroad_slightly_right` - плавный поворот направо, </li><li> `ringroad_forward` - проезд по кольцу прямо, </li><li> `ringroad_left_45` - поворот на кольце на 45 градусов влево, </li><li> `ringroad_left_90` - поворот на кольце на 90 градусов влево, </li><li> `ringroad_left_135` - поворот на кольце на 135 градусов влево, </li><li> `ringroad_left_180` - поворот на кольце на 180 градусов влево, </li><li> `ringroad_right_45` - поворот на кольце на 45 градусов вправо, </li><li> `ringroad_right_90` - поворот на кольце на 90 градусов вправо, </li><li> `ringroad_right_135` - поворот на кольце на 135 градусов вправо, </li><li> `ringroad_right_180` - поворот на кольце на 180 градусов вправо, </li><li> `turn_over_right_hand` - разворот (для правостороннего движения), </li><li> `turn_over_left_hand` - разворот (для левостороннего движения), </li><li> `toll_icon` - платная дорога, </li><li> `indoor_enter` - вход в здание, </li><li> `indoor_exit` - выход из здания, </li><li> `indoor_floor_change_stairway` - смена этажа по лестнице, </li><li> `indoor_floor_change_elevator` - смена этажа на лифте, </li><li> `indoor_floor_change_escalator` - смена этажа на эскалаторе. </li></ul>

Параметры пути после маневра

Длина участка маршрута в метрах

Время проезда по участку маршрута в секундах

Идентификатор этажа до маневра

Идентификатор этажа после маневра

Человекочитаемое описание пути

Тип препятствия: <ul type="disk"> <li> `barrier` - шлагбаум, </li><li> `gate` - ворота, </li><li> `tourniquet` - турникет, </li><li> `wicket` - калитка. </li></ul>

Тип оплаты проезда: <ul type="disk"> <li> `unpaid` - бесплатный (свободный), </li><li> `paid` - платный, </li><li> `pass` - по пропускам. </li></ul>

Въезд/съезд с платной дороги: <ul type="disk"> <li> `toll_type_start` - въезд на платную дорогу, </li><li> `toll_type_end` - съезд с платной дороги. </li></ul>

Тип проезда: <ul type="disk"><li> `main` - центральный (основной), </li><li> `additional` - дополнительный, </li><li> `service` - служебный. </li></ul>

Номер съезда для типа маневра `ringroad`

Угол поворота (для типов манёвров `crossroad` и `ringroad`)

Тип поворота на перекрёстке: <ul type="disk"><li> `straight` - движение прямо, </li><li> `slightly_left` - плавный поворот налево, </li><li> `left` - поворот налево, </li><li> `sharply_left` - крутой поворот налево, </li><li> `sharply_right` - крутой поворот направо, </li><li> `right` - поворот направо, </li><li> `slightly_right` - плавный поворот направо, </li><li> `uturn_right` - разворот (для правостороннего движения), </li><li> `uturn_left` - разворот (для левостороннего движения). </li></ul>

Тип маневра: <ul type="disk"> <li> `begin` - начало движения, </li><li> `end` - конец движения, </li><li> `crossroad` - проезд через перекрёсток, </li><li> `ringroad` - кольцевое движение с указанием съезда, </li><li> `pass_through` - иной проезд (шлагбаум, ворота, пропуск и т.д.), </li><li> `turn_over` - разворот, </li><li> `indoor_enter` - вход в здание, </li><li> `indoor_exit` - выход из здания, </li><li> `indoor_floor_change` - смена этажа в здании. </li></ul>

Формат выдачи результата: <ul type="disk"> <li> `simple` - упрощенная выдача, в ответе только время и длина маршрута; </li><li> `full` - полная выдача с геометрией маршрута. </li></ul>

Направление движения (в градусах)

Расстояние в метрах от начальной точки, на котором должно быть сохранено направление движения

Идентификатор этажа здания (для построения маршрута внутри здания)

Идентификатор здания или организации, к которой будет привязана точка

Если true, точка является начальной точкой маршрута. Если параметр не указан, начальной точкой является первая точка в массиве.

Тип точки: <ul type="disk"> <li> `stop` - начальная/конечная точка маршрута (прямой путь до дороги), </li><li> `walking` - начальная/конечная точка маршрута (пешеходный путь до дороги), </li><li> `pref` - промежуточная точка маршрута.</li></ul>

Градусы восточной долготы

Градусы северной широты

Z-уровень точки (вертикальный уровень на транспортных развязках)

Количество альтернативных маршрутов

Типы дорог, которые следует избегать при построении маршрута.

Если true, в ответ будет добавлена информация о высоте маршрута.

Дополнительные настройки построения: <ul type="disk"> <li> `pedestrian_instructions` - включить инструкции по навигации для пешеходных маршрутов </li> </ul>

Формат выдачи результата

Название начальной точки

Название конечной точки

Координаты для маршрута (массив точек)

Тип маршрута: <ul type="disk"> <li> `jam` - кратчайший по времени с учётом текущих пробок, </li><li> `statistic` - кратчайший по времени с учётом статистических данных по пробкам, </li><li> `shortest` - кратчайший по расстоянию, </li><li> `taxi_jam` - с учётом полос общественного транспорта и текущих пробок, </li><li> `taxi_statistic` - с учётом полос общественного транспорта и статистических данных по пробкам, </li><li> `taxi_shortest` - кратчайший по расстоянию с учётом полос общественного транспорта, </li><li> `emergency` - маршрут для экстренных служб, </li><li> `pedestrian` - пешеходный маршрут, </li><li> `bicycle` - велосипедный маршрут. </li></ul>

Если true, то будет построен маршрут внутри зданий (для пешеходных маршрутов).

Дата и время, на которые производится расчёт маршрута. Указывается как <a href='https://ru.wikipedia.org/wiki/Unix-время' target='_blank'>Unix-время</a>.

Тип маршрута в виде человекочитаемой строки

Если true, часть маршрута проходит по перекрытым дорогам.

Типы дорог, которые есть в построенном маршруте (из списка тех, которые можно избежать).

Идентификатор варианта проезда по маршруту

Точность маршрута в виде числа от 0 до 1 (если был указан параметр `distance_direction`)

Типы дорог, которые нужно было избежать при построении маршрута.

Типы дорог, которые были успешно исключены из маршрута.

Идентификатор маршрута

Длина маршрута в метрах

Время в пути в секундах

Внутренний тип объекта

Длина маршрута в виде человекочитаемой строки

Время в пути в виде человекочитаемой строки

Массив оригинальных и соответствующих им притянутых точек маршрута

Если true, точка является промежуточной

Информация о входах в метро

Геометрия участка маршрута

Информация о проезде на автомобиле

Геометрия автомобильного маршрута в формате WKT (LINESTRING)

Тип маршрута: <ul type="disk"> <li> `jam` - кратчайший по времени с учётом текущих пробок, </li><li> `statistic` - кратчайший по времени с учётом статистических данных по пробкам. </li></ul>

Объект, описывающий вход в метро

Если true, через данный вход можно выйти наружу.

Комментарий к выходу из метро

Координаты входа в метро в формате WKT (POINT)

Логотип ветки метро для выхода (если он есть)

Если true, выход находится на другой ветке.

Информация о перемещении с использованием метро

Номера частей состава, в которые рекомендуется посадка (максимум 3 номера). Части нумеруются слева направо. Поле используется для городов с небольшим метро.

Номера частей состава, в которые рекомендуется посадка (максимум 5 номеров). Части нумеруются слева направо. Поле используется вместо `boarding_parts_suggest` для городов с большим метро.

Подсказка, описывающая часть состава, в которую нужно сесть. Поле используется для городов с небольшим метро.

Подсказка, описывающая часть состава, в которую нужно сесть. Поле используется вместо `boarding_suggest` для городов с большим метро.

Подсказка направления движения

Описывает место, из которого (в которое) необходимо уехать (приехать).

Описывает геометрию перемещения. Заполняется только для типов - passage, walkway, crossing.

Геометрия в формате WKT (LINESTRING).

Z-уровень начальной координаты. Заполняется для типов walkway и crossing.

Z-уровень последней координаты. Заполняется для типов walkway и crossing.

Идентификатор перемещения

Все маршруты, идущие на данном участке, сгруппированные по типу транспорта.

Заполняется, если перемещение можно совершить несколькими видами транспорта или если единственный тип транспорта не является метро или авто.

Тип перемещения: <ul type="disk"><li> `passage` - проезд на транспорте </li><li> `walkway` - пешеходный участок маршрута </li><li> `crossing` - перемещение между разными платформами, входами в метро, парковками </li><li> `driving` - автомобильный участок маршрута </li></ul>

Сан Сити, многофункциональный комплекс

Произвольное текстовое обозначение

Идентификатор здания или организации, к которой будет привязана точка.

Список промежуточных остановок маршрута

Названия промежуточных остановок

Название остановки, после которой нужно выйти.

82,776851 54,982770

82,988150 55,017812

Если true, ответ будет содержать расписание для используемого транспорта.

Максимальное количество вариантов маршрута в ответе

Дата и время начала движения. Указывается как <a href='https://ru.wikipedia.org/wiki/Unix-время' target='_blank'>Unix-время</a>. Если параметр не указан, используется текущее время.

Виды общественного транспорта, которые могут быть использованы при построении маршрута: <ul type="disk"> <li> `aeroexpress` - Аэроэкспресс </li><li> `bus` - автобус </li><li> `cable_car` - канатная дорога </li><li> `funicular_railway` - фуникулёр </li><li> `light_metro` - легкое метро </li><li> `light_rail` - легкорельсовый транспорт </li><li> `mcc` - Московское центральное кольцо </li><li> `mcd` - Московские центральные диаметры </li><li> `metro` - метро </li><li> `monorail` - монорельс </li><li> `premetro` - подземный трамвай </li><li> `river_transport` - речной транспорт </li><li> `shuttle_bus` - маршрутное такси </li><li> `suburban_train` - пригородный поезд </li><li> `tram` - трамвай </li><li> `trolleybus` - троллейбус </li></ul>

список маршрутов между точками

Описывает один из вариантов маршрута

Количество пересадок, для которых нужно перейти на другую платформу.

Список перемещений (участков маршрута)

Если true, маршрут полностью пешеходный.

Расписание движения транспорта

Расписание дополнительных событий для транспорта

Продолжительность пешеходной части маршрута в виде локализованной строки

Количество пересадок в рамках одной платформы

Используемые виды транспорта

Описание маршрута, идущего на заданном участке

Локализованное название вида транспорта

Расписание транспорта

Период следования транспорта в минутах (для типа расписания `periodic`)

Время прибытия в формате "ЧЧ:ММ"

Дата и время прибытия в формате <a href='https://ru.wikipedia.org/wiki/Unix-время' target='_blank'>Unix-времени</a>

Тип расписания: <ul type="disk"><li> `precise` - с указанием времени прибытия </li><li> `periodic` - только период следования </li></ul>

Событие для транспортного маршрута

Время события в формате "ЧЧ:ММ"

Дата и время события в формате <a href='https://ru.wikipedia.org/wiki/Unix-время' target='_blank'>Unix-времени</a>

Тип события: <ul type="disk"><li> `night_break` - ночной перерыв </li><li> `begin_trips` - скорый рейс </li></ul>

Краткая информация о начальной точке перемещения

Если true, то участок маршрута можно проехать на разных видах транспорта.

Дополнительная информация (например, продолжительность пешеходного участка маршрута)

Координаты или название начальной точки перемещения

Тип движения: <ul type="disk"> <li> `driving` — автомобильный, </li><li> `truck` — грузовой транспорт, </li><li> `taxi` — автомобильный с учётом полос общественного транспорта, </li><li> `walking` — пешеходный, </li><li> `bicycle` — велосипедный. </li></ul>

Идентификаторы пропуска в пропускную зону (массив чисел)

Результат построения матрицы смежности

Типы дорог, которые следует избегать при построении маршрута. Можно указать строку (один тип дорог) или массив строк (несколько типов дорог). <ul type="disk"> <li> `dirt_road` - грунтовые дороги (для автомобильных и пешеходных маршрутов), </li><li> `toll_road` - платные дороги (для автомобильных маршрутов), </li><li> `ferry` - переправы (для автомобильных и пешеходных маршрутов), </li><li> `highway` - магистральные дороги (для пешеходных маршрутов), </li><li> `ban_car_road` - автомобильные дороги (для велосипедных маршрутов), </li><li> `ban_stairway` - лестницы (для велосипедных маршрутов), </li><li> `ban_over` - подземные и надземные переходы (для велосипедных маршрутов). </li></ul>

Детальная информация о ребре маршрута, включая геометрию

Cкорость проезда по ребру по умолчанию

Геометрия ребра как массив точек.

Ожидаемая скорость проезда по ребру - с учётом статистики

Размер исключаемой области в метрах

Координаты исключаемой области (массив точек)

Как строго нужно избегать заданную область.

Форма исключаемой области

Как строго нужно избегать заданную область: <ul type="disk"> <li> `soft` - избегать по возможности, </li><li> `hard` - избегать всегда. </li></ul>

Форма исключаемой области: <ul type="disk"> <li> `point` - круг с радиусом, равным `extent` (`points` - центр окружности); </li><li> `polyline` - ломаная линия с шириной, равной `extent` (`points` - вершины линии); </li><li> `polygon` - многоугольник (`points` - вершины многоугольника). </li></ul>

Угол наклона участка маршрута (если в запросе был указан параметр `need_altitudes`)

Название стиля отображения геометрии: <ul type="disk"> <li> `fast` - зелёная линия, </li><li> `normal` - жёлтая линия, </li><li> `slow` - красная линия, </li><li> `slow-jams` - тёмно-красная линия, </li><li> `ignore` - не отображаем скорости, </li><li> `no-traffic` - нет скоростей на маршруте. </li></ul>

Наличие полосы общественного транспорта в геометрии

Геометрия части маршрута в формате WKT

Индикатор надземной/подземной части маршрута: <ul type="disk"> <li> `zlevel-normal` - наземная часть маршрута, </li><li> `zlevel-positive` - надземная часть маршрута, </li><li> `zlevel-negative` - подземная часть маршрута. </li></ul>

Координаты начальной точки, которые используются для построения области (могут немного отличаться от `start_point`)

Отрезок времени, для которого построена эта область

Массив вершин многоугольника

Геометрия области в формате WKT

Координаты начальной точки в формате WGS84

Массив отрезков времени, за которые нужно добраться до конечной точки

Тип движения: <ul type="disk"> <li> `driving` - автомобильный </li><li> `walking` - пешеходный </li><li> `bicycle` - велосипедный </li></ul>

Реверсивность движения: <ul type="disk"> <li> `false` - движение от указанной точки до границ области </li><li> `true` - движение от границ области до указанной точки </li></ul>

Детализированность многоугольника: <ul type="disk"> <li> `true` - низкая </li><li> `false` - высокая </li></ul>

Дата и время начала движения в формате <a href='https://tools.ietf.org/html/rfc3339#section-5.8' target='_blank'>RFC 3339</a> (например, <i>2020-05-15T15:52:01Z</i>)

Построение достижимой области на карте

Детальное описание ошибки, если она была

Время генерации ответа, в секундах

Статус обработки запроса: <ul type="disk"> <li> `OK` - область построена успешно </li><li> `incorrect_input` - некорректный ввод </li><li> `build_error` - ошибка построения области </li><li> `attract_error` - ошибка вычисления </li><li> `serialize_error` - ошибка сериализации </li></ul>

Маршрут матрицы смежности

Индекс точки отправления (из массива `points`)

Статус обработки запроса: <ul type="disk"> <li> `OK` - маршрут построен успешно, </li><li> `FAIL` - неизвестная ошибка построения маршрута, </li><li> `ATTRACT_FAIL` - не удалось притянуть точки к дорожному графу: одна из точек маршрута удалена от дорожного графа более, чем на 10 км, </li><li> `ROUTE_DOES_NOT_EXISTS` - маршрут между точками на дорожном графе не существует, </li><li> `ROUTE_NOT_FOUND` - маршрут не удалось построить на текущих данных дорожного графа, </li><li> `POINT_EXCLUDED` - точки попали в зону исключения. </li></ul>

Индекс точки прибытия (из массива `points`)

Название иконки маневра: <ul type="disk"> <li> `start` - начало движения, </li><li> `finish` - конец движения, </li><li> `crossroad_straight` - движение прямо, </li><li> `crossroad_slightly_left` - плавный поворот налево, </li><li> `crossroad_left` - поворот налево, </li><li> `crossroad_sharply_left` - крутой поворот налево, </li><li> `crossroad_sharply_right` - крутой поворот направо, </li><li> `crossroad_right` - поворот направо, </li><li> `crossroad_slightly_right` - плавный поворот направо, </li><li> `ringroad_forward` - проезд по кольцу прямо, </li><li> `ringroad_left_45` - поворот на кольце на 45 градусов влево, </li><li> `ringroad_left_90` - поворот на кольце на 90 градусов влево, </li><li> `ringroad_left_135` - поворот на кольце на 135 градусов влево, </li><li> `ringroad_left_180` - поворот на кольце на 180 градусов влево, </li><li> `ringroad_right_45` - поворот на кольце на 45 градусов вправо, </li><li> `ringroad_right_90` - поворот на кольце на 90 градусов вправо, </li><li> `ringroad_right_135` - поворот на кольце на 135 градусов вправо, </li><li> `ringroad_right_180` - поворот на кольце на 180 градусов вправо, </li><li> `turn_over_right_hand` - разворот (для правостороннего движения), </li><li> `turn_over_left_hand` - разворот (для левостороннего движения), </li><li> `toll_icon` - платная дорога. </li></ul>

Тип проезда: <ul type="disk"> <li> `main` - центральный (основной),  </li><li> `additional` - дополнительный,  </li><li> `service` - служебный. </li></ul>

Тип маневра: <ul type="disk"> <li> `begin` - начало движения, </li><li> `end` - конец движения, </li><li> `crossroad` - проезд через перекрёсток, </li><li> `ringroad` - кольцевое движение с указанием съезда, </li><li> `pass_through` - иной проезд (шлагбаум, ворота, пропуск и т.д.), </li><li> `turn_over` - разворот. </li></ul>

Описание ошибки (например, `Invalid value: 'lon' = 31415 at index 2`)

Тип ошибки : <ul type="disk"> <li> `Invalid_Request` - ошибка схемы JSON, </li><li> `Bad_Request` - ошибка данных.</li></ul>

Массив отдельных участков маршрута с длительностью проезда и геометрией

Геометрия участка маршрута в формате WKT

Координаты в WGS84 и данные объекта

Дата и время записи точки маршрута. Указывается как <a href='https://ru.wikipedia.org/wiki/Unix-время' target='_blank'>Unix-время</a>.

Массив точек для построения маршрута

Результат восстановления маршрута

Длина восстановленного маршрута в метрах

Длительность восстановленного маршрута в секундах

Геометрия восстановленного маршрута в формате WKT

Результат восстановления маршрута: <ul type="disk"> <li> `OK` - маршрут восстановить удалось, </li><li> `FAIL` - маршрут восстановить не удалось.</li></ul>

Координаты в WGS84, данные объекта и восстановленные координаты

Оригинальные координаты, градусы северной широты

Восстановленные координаты, градусы северной широты

Оригинальные координаты, градусы восточной долготы

Восстановленные координаты, градусы восточной долготы

Направление движения в первой точке (в градусах)

Направление движения во второй точке (в градусах)

Широта точки отправления

Долгота точки отправления

Pairs Directions API