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

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

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

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

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

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

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

  • Схема проезда для различных видов транспорта, включая общественный транспорт, автомобиль, пешую прогулку или велосипед.
  • Многоэтапные маршруты, построенные на основе последовательности путевых точек.
  • Указывайте пункты отправления, назначения и путевые точки различными способами, в том числе в виде текстовых строк (например, "Chicago, IL" или "Darwin, NT, Australia"), идентификаторов мест или координат широты/долготы.

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

Что дальше?