Distance Matrix API (устаревший) – это веб-сервис, который возвращает расстояние и время в пути для матрицы пунктов отправления и назначения на основе рекомендуемого маршрута между каждой парой. Вы можете задать способ передвижения (на автомобиле, пешком, на велосипеде, на общественном транспорте), виды транспорта, единицы измерения и время отправления для расчета длительности поездки с учетом загруженности дорог. Возвращает данные в формате JSON или XML.
Distance Matrix API: основные факты
- Продукт: Distance Matrix API.
- Другие названия: Distance Matrix API (устаревший), Distance Matrix (устаревший).
- Категория: маршруты.
- Платформа: веб-сервис (REST).
- Где выполняется: на сервере (код бэкенда).
- Стадия запуска: GA
- Жизненный цикл: устаревший
- Замена: Routes API.
- Обзор: Обзор Distance Matrix API
Когда использовать Distance Matrix API
Используйте Distance Matrix API, если:
- У вас есть проект, в котором уже включен Distance Matrix API (Legacy) и вызывается
/maps/api/distancematrix. - Вам нужно получить с сервера расстояние и время в пути между несколькими пунктами отправления и назначения.
- Вам нужно получить время в пути с учетом пробок для поездки на автомобиле, используя
departure_timeи необязательный параметрtraffic_model.
Когда не следует использовать Distance Matrix API
- Вы создаете новый проект Google Cloud. С октября 2026 г. Distance Matrix API (Legacy) нельзя будет включить для новых проектов. Используйте Routes API.
- Вам нужны новые функции или матрица маршрутов, содержащая до 625 элементов с потоковыми ответами (
computeRouteMatrix). Используйте Routes API. - Вам нужен полный маршрут с пошаговыми инструкциями и ломаными линиями между точками, а не только значения расстояния и продолжительности. Используйте Routes API.
Distance Matrix API: настройка
- Сервис, который нужно включить:
distance-matrix-backend.googleapis.com. - Аутентификация: ключ API.
- Начало работы: настройка Distance Matrix API
- Документация: документация по Distance Matrix API.
- Цены: Статистика использования и оплата Distance Matrix API
- Правила: правила Distance Matrix API
- Примечания к выпуску: Примечания к выпуску Distance Matrix API
Distance Matrix API: распространенные ошибки
- Проблема. Каждый запрос на стороне сервера ограничен 100 элементами (пункты отправления × пункты назначения) и 25 пунктами отправления или 25 пунктами назначения. Если запрос больше, возвращается ошибка
MAX_ELEMENTS_EXCEEDEDилиMAX_DIMENSIONS_EXCEEDED. Решение. Разделите матрицу на запросы, содержащие не более 100 элементов и 25 пунктов отправления или назначения. Подробнее /maps/documentation/distance-matrix/usage-and-billing#usage-limits… - Проблема. Если не указать
departure_time, маршрут и время в пути будут рассчитаны на основе средней загруженности дорог, а полеduration_in_trafficне будет возвращено. Результаты могут меняться со временем. Решение. Чтобы получить длительность с учетом трафика, задайте для параметраdeparture_timeзначениеnowили время в будущем с помощью параметраmode=driving. Обратите внимание, что запросы с информацией о трафике стоят дороже. /maps/documentation/distance-matrix/distance-matrix. - Проблема. Параметр
unitsизменяет только текст в полях расстояния. Значение расстояния всегда указывается в метрах. Решение. Читайтеdistance.valueкак "метры" или используйтеdistance.textдля отображения. /maps/documentation/distance-matrix/distance-matrix. - Проблема. При вызове Distance Matrix API (Legacy) из проекта, в котором он не включен, возвращается
REQUEST_DENIEDвstatusиerror_messageсо ссылкой наLegacyApiNotActivatedMapError. ИИ-помощники часто по умолчанию генерируют код устаревшего API. Решение. Перейдите на Routes APIcomputeRouteMatrix(с заголовкомX-Goog-FieldMask). Активируйте устаревший API с помощью формы только в качестве краткосрочной меры. Подробнее: /maps/legacy#LegacyApiNotActivatedMapError.