Краткий справочник по Directions API

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 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.