Зачем использовать 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, а также возвращаемые данные.
Ресурсы данных | Данные возвращены | Формат возврата |
---|---|---|
Направления Укажите места происхождения и назначения в виде идентификаторов мест, адресов или координат широты и долготы. Подробности смотрите в обязательных параметрах . | Подробные указания, разбитые на маршруты, этапы и шаги. Подробности см. в разделе «Ответы по направлениям» . |
|
Как использовать API маршрутов
1 | Настройтесь. | Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке. |
2 | Попробуйте демо | Если у вас есть ключ API и облачный проект, вы можете бесплатно опробовать демо-версию направлений. См . демонстрацию API Directions . |
3 | Создать запрос | Ознакомьтесь с примерами запросов и узнайте о доступных опциях, которые вы можете предоставить, таких как режимы передвижения, путевые точки и ограничения маршрута. См. примеры направлений . |
4 | Понимать основы ответа | Изучите ответы данных, чтобы подготовиться к использованию данных о маршрутах в своем приложении. Подробности см. в разделе «Ответы по направлениям» . |
5 | Включите данные о направлениях в свое собственное приложение! | Вы можете использовать эти данные для расчета расстояния и времени путешествия. |
Доступные клиентские библиотеки
Вызовите этот API на выбранном вами языке через одну из следующих клиентских библиотек:
- Java-клиент для сервисов Google Maps
- Клиент Python для сервисов Google Maps
- Клиент Go для сервисов Google Maps
- Клиент Node.js для сервисов Google Maps
Клиент Java, клиент Python, клиент Go и клиент Node.js для служб Google Maps — это клиентские библиотеки, поддерживаемые сообществом, с открытым исходным кодом по лицензии Apache 2.0 . Загрузите их с GitHub, где вы также можете найти инструкции по установке и пример кода.
Что дальше
- Начните использовать API направлений : перейдите в раздел «Начало работы» .
- Начните запрашивать маршруты : перейдите в раздел «Проложить маршруты» .
- Следуйте рекомендациям . Перейдите к разделу «Рекомендации по работе с веб-службами» .