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

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

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

Зачем использовать Directions API (Legacy)

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

Что можно делать с помощью Directions API (устаревшая версия)

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

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

Как работает Directions API (устаревшая версия)

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

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

В примере ниже показан запрос, который возвращает маршрут из Торонто (Онтарио) в Монреаль (Квебек) в формате JSON.

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

Ресурсы

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

Ресурсы данных Возвращенные данные Формат возвращаемого значения
Directions

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

Подробные маршруты, разбитые на участки и шаги. Подробную информацию можно найти в разделе Ответы Directions API.
  • JSON
  • XML

Как использовать Directions API (устаревшая версия)

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

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

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

Клиенты для Java, Python, Go и Node.js для сервисов Google Карт – это клиентские библиотеки, поддерживаемые сообществом, на базе ПО с открытым исходным кодом, которые предоставляются согласно лицензии Apache 2.0. Их можно скачать на сайте GitHub, где также опубликованы образцы кода и инструкции по установке.

Дальнейшие действия