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