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

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>]
  & [avoid_unpaved=<boolean>]
  & [avoid_poor_condition=<boolean>]
  & [avoid_zones=<lat1,lon1|lat2,lon2|...>&avoid_zones=<lat1,lon1|lat2,lon2|...>]
  & [traffic=<string>]
  & [weight=<float>]
  & [axle_weight=<float>]
  & [max_weight=<float>]
  & [height=<float>]
  & [width=<float>]
  & [length=<float>]
  & [payload=<float>]
  & [eco_class=<integer>]
  & [has_trailer=<boolean>]
  & [vehicle_permits=<string>]
  & [signature=<string>]

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

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 — маршрут с использованием общественного транспорта;
  • bicycle — маршрут для велосипеда;
  • scooter — маршрут для электросамоката.

Важно

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

При планировании маршрутов для электросамокатов также будут учитываться ограничения в соответствии с ПДД РФ. Учитывается знак 3.35.

departure_time

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

Важно

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

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

avoid_tolls

Запрет на использование платных дорог. При значении true маршрут будет построен в обход платных дорог. Значение по умолчанию — false (только для mode=driving или mode=truck).

avoid_unpaved

Запрет на использование дорог без твёрдого покрытия. При значении true маршрут будет построен в обход дорог без твёрдого покрытия. Значение по умолчанию — false (только для mode=driving или mode=truck).

Доступ к этому параметру предоставляется на платных тарифах.

avoid_poor_condition

Запрет на использование дорог в плохом состоянии. При значении true маршрут будет построен в обход дорог в плохом состоянии. Значение по умолчанию — false (только для mode=driving или mode=truck).

Доступ к этому параметру предоставляется на платных тарифах.

avoid_zones

Задание произвольной геозоны на карте, дороги внутри которой надо исключить при построении маршрутов. Можно задавать несколько геозон в 1 запросе. Каждая геозона минимум 3 точки (только для mode=driving или mode=truck).

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.

vehicle_permits

Только для mode=truck

Пропуска для въезда в определённые зоны. Список значений, разделённых запятой. Допустимые значения:

  • msk_mkad - разрешает въезд на МКАД и внутрь МКАДА в Москве
  • msk_ttk - разрешает въезд на ТТК и внутрь ТТК в Москве
  • msk_sk - разрешает въезд на Садовое кольцо и внутрь Садового кольца в Москве
  • spb_kad - разрешает въезд на КАД и внутрь КАДа в Санкт-Петербурге

Доступ к этому параметру предоставляется на платных тарифах.

signature

Подпись запроса. Служит для защиты ключа от кражи. Более подробно о подключении механизма подписи запросов можно узнать в документации.
Предыдущая
Быстрый старт
Следующая
Формат ответа