Формат запроса

https://api.routing.yandex.net/v2/distancematrix
  ? apikey=<string>
  & origins=<lat1,lon1|lat2,lon2|...>
  & destinations=<lat1,lon1|lat2,lon2|...>
  & [mode=<string>]
  & [departure_time=<integer>]
  & [avoid_tolls=<boolean>]
  & [traffic=<string>]
  & [weight=<float>]
  & [axle_weight=<float>]
  & [max_weight=<float>]
  & [height=<float>]
  & [width=<float>]
  & [length=<float>]
  & [payload=<float>]
  & [eco_class=<integer>]
  & [has_trailer=<boolean>]

Все параметры

apikey

Обязательный параметр

Ключ, полученный в Кабинете Разработчика.

Примечание

Ключ будет активирован в течение 15 минут после получения.

origins

Обязательный параметр

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

Максимальное количество точек, которые можно указать в одном запросе: 100.

Примечание

Максимальный размер матрицы составляет 100 элементов. Например, можно указать 10 origins и 10 destination в одном запросе, но нельзя указать 50 origins и 10 destinations, так как полученная матрица будет содержать 500 элементов.

destinations

Обязательный параметр

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

Максимальное количество точек, которые можно указать в одном запросе: 100.

Примечание

Максимальный размер матрицы составляет 100 элементов. Например, можно указать 10 origins и 10 destination в одном запросе, но нельзя указать 50 origins и 10 destinations, так как полученная матрица будет содержать 500 элементов.

mode

Способ перемещения по маршруту. Допустимые значения:

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

Важно

При планировании маршрутов для грузовых автомобилей будут учитываться ограничения в соответствии с ПДД РФ. Учитываются знаки 3.4, 3.7, 3.11, 3.12, 3.13, 3.14, 3.15, 5.35, 5.36 и табличка 8.11.

departure_time

Время отправления в формате UNIX-времени. Используется для расчета ожидаемых пробок на дорогах. Если параметр отсутствует, используется прогноз пробок на момент обработки запроса.
Параметр не может принимать значения времени в прошлом.

Важно

Параметр не учитывается при расчете маршрута:

  • для пешеходов (mode=walking),
  • без учета дорожного трафика (traffic=disabled).

avoid_tolls

Запрет на использование платных дорог. При значении true маршрут будет построен в обход платных дорог. Значение по умолчанию — false.

traffic

Изменение типа дорожного трафика. При значении disabled маршрут будет построен по кратчайшему расстоянию, без учета пробок (только для mode=driving или mode=truck).

weight

Масса транспортного средства в тоннах (только для mode=truck).

axle_weight

Фактическая нагрузка на ось транспортного средства в тоннах (только для mode=truck).

max_weight

Разрешенная максимальная масса транспортного средства в тоннах (только для mode=truck).

height

Высота транспортного средства в метрах (только для mode=truck).

width

Ширина транспортного средства в метрах (только для mode=truck).

length

Длина транспортного средства в метрах (только для mode=truck).

payload

Максимальная грузоподъёмность транспортного средства в тоннах (только для mode=truck).

eco_class

Экологический класс транспортного средства (только для mode=truck).

has_trailer

Наличие прицепа (только для mode=truck). Значение по умолчанию — false.
Предыдущая
Быстрый старт
Следующая
Формат ответа