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

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

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

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

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

Что можно сделать с помощью API маршрутов?

С помощью 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, Python, Go и Node.js для сервисов Google Карт — это поддерживаемые сообществом клиентские библиотеки с открытым исходным кодом под лицензией Apache 2.0 . Загрузите их с GitHub, где также можно найти инструкции по установке и примеры кода.

Что дальше?