Обзор
Distance Matrix API позволяет получить информацию о расстоянии и времени в пути между точками на карте.
Вы можете задать несколько пунктов отправления (начальных точек) и пунктов назначения (конечных точек) и получить расстояние и время в пути между каждой возможной парой точек отправления и назначения. Например, для трёх точек отправления (А, B, C) и трёх точек прибытия (D, E, F) Distance Matrix API рассчитает матрицу с расстоянием и временем для девяти вариантов маршрутов: AD, AE, AF, BD, BE, BF, CD, CE, CF.
Distance Matrix API поддерживает два режима работы:
- Синхронный — для расчёта запросов, содержащих до 25 точек отправления или прибытия. В этом режиме запрос сразу возвращает результат.
- Асинхронный — для расчёта запросов, содержащих больше 25 точек отправления или прибытия. В этом режиме запрос возвращает идентификатор задачи, который нужно использовать для периодической проверки готовности результата. Если вам необходимо использовать этот режим, напишите в службу поддержки.
Таким образом, вы можете использовать Distance Matrix API, чтобы определить наиболее эффективные маршруты передвижения между несколькими возможными пунктами отправления и назначения, а также для реализации собственных алгоритмов решения транспортных задач. Сценарии использования см. в Примерах.
Distance Matrix API возвращает только краткую информацию о маршруте (расстояние и время). Для получения полной геометрии маршрута используйте Routing API.
Наведите курсор на метку на карте, чтобы узнать расстояние и время езды до неё на автомобиле от точки отправления.
Тарифы
- При отправке запросов к Distance Matrix API оплачивается количество не запросов, а расчётов для каждой пары точек отправления и прибытия. Например, в одном запросе вы указываете 2 точки отправления и 3 точки прибытия, поэтому оплачиваются 6 расчётов.
- Актуальные тарифы можно посмотреть в Менеджере Платформы, в блоке Базовые сервисы.
Важно
1 декабря 2025 года обновлена сетка тарифов на API-сервисы. Подробнее об изменениях см. в личном кабинете.