Directions API (устаревшая версия) – это веб-сервис, который рассчитывает маршруты между местоположениями для поездок на автомобиле, велосипеде, общественном транспорте и пеших прогулок, включая составные маршруты с путевыми точками, и возвращает маршруты, отрезки и шаги в формате JSON или XML. У него устаревший статус: с октября 2026 года его нельзя будет включить для новых облачных проектов Google Cloud. Перейдите на Routes API.
Directions API: основные сведения
- Продукт: Directions API.
- Другое название: Directions API (устаревший).
- Категория: маршруты.
- Платформа: веб-сервис (REST).
- Где выполняется: на сервере (код бэкенда).
- Стадия запуска: GA
- Жизненный цикл: устаревший
- Замена: Routes API.
- Обзор: Обзор Directions API
- Регионы: все страны. Покрытие зависит от региона и способа передвижения (данные об общественном транспорте предоставляются транспортными компаниями). (подробнее о покрытии)
Когда использовать Directions API
Используйте Directions API, если:
- У вас есть существующий облачный проект Google Cloud, в котором уже включен Directions API (устаревший) и вызывается
maps/api/directions. - Вам нужны маршруты на стороне сервера для автомобилей, пешеходов, велосипедов или общественного транспорта (путевые точки только для режимов, отличных от общественного транспорта) в формате JSON или XML в существующем проекте.
Когда не следует использовать Directions API
- Вы начинаете новый облачный проект Google Cloud. С октября 2026 г. устаревший Directions API нельзя будет включить для новых проектов. Используйте Routes API.
- Вам нужны новые функции маршрутизации и повышенная производительность. Используйте Routes API.
- Вам нужно получить время в пути и расстояние для нескольких пунктов отправления и назначения в одном запросе. Используйте Routes API.
Directions API: настройка
- Сервис, который нужно включить:
directions-backend.googleapis.com. - Аутентификация: ключ API.
- Начало работы: настройка Directions API
- Документация: документация по Directions API.
- Цены: Статистика использования и оплата Directions API
- Правила: правила Directions API.
- Примечания к выпуску: примечания к выпуску Directions API.
Directions API: распространенные ошибки
- Проблема. Запросы к Directions API (Legacy) из проекта, в котором устаревший API не включен, завершаются ошибкой
LegacyApiNotActivatedMapError. Решение. Если вы владелец приложения, перейдите на Routes API. В качестве временного решения на период перехода или ожидания обновления приложения вы можете активировать устаревший API, заполнив форму активации устаревшего API. Подробнее: /maps/legacy. - Проблема. Использование префикса
via:для путевых точек делает их обязательными для прохождения, что может привести к серьезным изменениям маршрута или получению статусаZERO_RESULTS. Решение. Используйте путевые точки с остановкой (без префиксаvia:), если вам не нужны точки без остановки. Подробнее: /maps/documentation/directions/get-directions. - Проблема. Запросы с 11–25 путевыми точками,
optimize:true, длительностью с учетом трафика (duration_in_traffic) или модификаторами местоположенияside_of_roadилиheadingоплачиваются по более высокому тарифу Directions Advanced (Pro). Решение. Используйте эти функции только при необходимости. Чтобы оставаться на уровне Essentials, не добавляйте более 10 путевых точек и не используйте параметрыoptimize:true,departure_time(для поездок на автомобиле),side_of_roadиheading. Подробнее: /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku. - Проблема. Для поездок на автомобиле значение
departure_timeне может быть в прошлом (запрос завершается с ошибкойINVALID_REQUEST). Безdeparture_timeмаршрут и продолжительность рассчитываются на основе средней загруженности дорог без учета времени, аduration_in_trafficне возвращается. Решение. Чтобы получатьduration_in_traffic, задайте для свойстваdeparture_timeзначениеnowили укажите время в будущем с помощью свойстваmode=driving. Запросы, возвращающиеduration_in_traffic, оплачиваются по коду SKU Directions Advanced (Pro). Подробнее: /maps/documentation/directions/get-directions.