Distance Matrix API

Matrix API рассчитывает время в пути и расстояния между каждой комбинацией точек отправления и назначения в одном запросе. Типичные сценарии применения: поиск ближайшего водителя или техника для выполнения заказа, решение задач маршрутизации транспортных средств, оценка временных окон доставки для клиентов, а также расчёт покрытия зоны обслуживания при планировании объектов.

Directions API возвращает единственный подробный маршрут между двумя точками, включая инструкции по поворотам и геометрию. Matrix API возвращает таблицу расстояний и продолжительности для нескольких пар «отправление, назначение» без геометрии маршрута. Если требуется эффективно сравнить множество местоположений, Matrix API быстрее и экономичнее, чем отдельные вызовы Directions API.

API поддерживает матрицы размером до 100 точек отправления на 100 точек назначения в одном запросе, что даёт до 10 000 пар «отправление, назначение» за один вызов. Матрицы не обязательно должны быть квадратными: можно отправить 1 точку отправления и 100 точек назначения для поиска ближайшего объекта или 50 на 50 для полного назначения «парк, клиент».

Matrix API поддерживает езду на автомобиле, ходьбу, езду на велосипеде и общественный транспорт. Режим передвижения устанавливается для каждого запроса. Все пары в одном запросе используют один и тот же режим. Если нужны результаты для разных режимов, отправьте отдельные запросы для каждого и объедините ответы в своём приложении.

По умолчанию Matrix API использует скорости движения в условиях свободного потока, характерные для типичных дорожных условий. Продолжительности с учётом трафика в реальном времени доступны на соответствующих тарифных планах. Установите параметр departure_time на будущую временную метку, чтобы получить оценки времени в пути с учётом времени суток на основе исторических данных о трафике.

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