Обзор API маршрутов (устаревшая версия)

Разработчики Европейской экономической зоны (ЕЭЗ)

Directions API (устаревший) — это служба, которая принимает HTTP-запросы и возвращает маршруты в формате JSON или XML между локациями.

Зачем использовать API маршрутов

С помощью API Directions вы можете получить маршруты для различных видов транспорта, таких как общественный транспорт, автомобиль, пешеход или велосипед.

Что можно делать с помощью API Directions?

С помощью API Directions вы можете рассчитать маршруты между локациями, включая следующую информацию:

  • Инструкции для различных видов транспорта, включая общественный транспорт, автомобиль, пешую или велосипедную езду.
  • Составные указания с использованием ряда путевых точек.
  • Укажите исходные пункты, пункты назначения и путевые точки несколькими способами, в том числе в виде текстовых строк (например, «Чикаго, Иллинойс» или «Дарвин, Северная Каролина, Австралия»), идентификаторов мест или координат широты/долготы.

Как работает API маршрутов

API Directions возвращает наиболее эффективные маршруты при расчете направлений. Продукт учитывает следующие элементы путешествия при определении наиболее эффективного маршрута:

  • Время в пути (основное)
  • Расстояние
  • Количество оборотов

Следующий пример запроса возвращает маршруты проезда из Торонто, Онтарио, в Монреаль, Квебек, в формате JSON:

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

Ресурсы

В следующей таблице обобщены ресурсы, доступные через API Directions, а также возвращаемые им данные.

Ресурсы данных Данные возвращены Формат возврата
Направления

Укажите исходные и конечные пункты в виде идентификаторов мест, адресов или координат широты/долготы. Подробности см. в требуемых параметрах .

 Подробные указания, разбитые на маршруты, этапы и шаги. Смотрите ответы на указания для получения подробной информации.
  • JSON
  • XML

Как использовать API маршрутов

1 Приступайте к работе. Начните с настройки проекта Google Cloud и следуйте инструкциям по настройке, приведенным ниже.
2 Попробуйте демо-версию После того, как у вас есть ключ API и облачный проект, вы можете бесплатно попробовать демо-версию Directions API. Смотрите демо-версию Directions API .
3 Создать запрос Посмотрите примеры запросов и узнайте о доступных вариантах, которые вы можете предоставить, таких как режимы движения, путевые точки и ограничения маршрута. Смотрите примеры направлений .
4 Понять основы реагирования Изучите ответы на данные, чтобы подготовиться к использованию данных маршрутов для вашего приложения. Подробнее см. в ответах маршрутов .
5 Добавьте данные о направлении в свое приложение! Вы можете использовать эти данные для расчета расстояния и времени в пути.

Доступные клиентские библиотеки

Вызовите этот API на языке по вашему выбору через одну из следующих клиентских библиотек:

Java Client, Python Client, Go Client и Node.js Client для Google Maps Services — это поддерживаемые сообществом клиентские библиотеки с открытым исходным кодом по лицензии Apache 2.0 . Загрузите их с GitHub, где вы также найдете инструкции по установке и пример кода.

Что дальше?