Обзор API маршрутов

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

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

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

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

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

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

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

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

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

Следующий пример запроса возвращает маршруты проезда из Торонто, Онтарио, в Монреаль, Квебек, в формате 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 и облачный проект, вы можете бесплатно опробовать демо-версию направлений. См. демонстрацию API Directions .
3 Создать запрос Ознакомьтесь с примерами запросов и узнайте о доступных опциях, которые вы можете предоставить, таких как режимы передвижения, путевые точки и ограничения маршрута. См. примеры направлений .
4 Понимать основы ответа Изучите ответы данных, чтобы подготовиться к использованию данных о маршрутах в своем приложении. Подробности см. в разделе «Ответы по направлениям» .
5 Включите данные о направлениях в свое собственное приложение! Вы можете использовать эти данные для расчета расстояния и времени путешествия.

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

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

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

Что дальше