Зачем использовать API маршрутов
�� пом��щью API маршрутов вы можете получать точные маршруты и информацию о поездках, используя сведения о транспорте, актуальные данные о пробках и дорожных условиях, а также настройки маршрута:
Вид и возможности разных видов транспорта
В каком направлении движется транспортное средство
Обочина дороги для посадки или высадки
Условия дорожного движения и перекрытие дорог
Проблемы безопасности, такие как избегание опасных зон или обеспечение безопасных мест посадки.
Сбалансируйте задержку, качество и стоимость в соответствии с вашими потребностями в маршрутизации с помощью дополнительных функций, таких как сборы за проезд и метаданные о поездке, такие как время и расстояние, а также топливная экономичность.
Вы также можете определить наиболее эффективные маршруты для планирования отправки, например:
Как лучше назначить набор рабочих для подбора серии посылок
Определите лучший склад для отправки посылок в конечный пункт назначения.
Что вы можете сделать с помощью Routes API?
С помощью Routes API вы можете получить две основные категории информации о маршрутизации:
Маршруты из одного места в один или несколько пунктов назначения
Матрица возможных маршрутов между множеством начальных и конечных точек.
Получите маршруты для одного или нескольких пунктов назначения
С помощью метода Routes API Compute Routes
вы можете рассчитывать между местоположениями:
Проложите маршруты для различных способов передвижения , а также для одного или нескольких пунктов назначения:
Виды транспорта, включая транзит, автомобиль, двухколесные транспортные ��редства, пешие прогулки или езду на велосипеде.
Серия путевых точек, которые вы можете оптимизировать для наиболее эффективного перемещения по ним.
Несколько способов указать пункты отправления, назначения и путевые точки :
Текстовые строки. Например: «Чикаго, Иллинойс», «Дарвин, Северная Каролина, Австралия», «1800 Amphitheatre Parkway, Mountain View, CA 94043» или «CWF6+FWX Mountain View, Калифорния».
Идентификаторы мест
Координаты широты и долготы, опционально с указанием курса автомобиля.
Настройте параметры маршрута в соответствии с вашими потребностями и целями:
Выберите топливные или энергоэффективные маршруты для типа двигателя вашего автомобиля: дизельный, электрический, гибридный, газовый. Дополнительную информацию см. в разделе «Проектирование экологически чистого маршрута» .
Установите более детальные параметры расчета трафика, что позволит вам принимать решения по компромиссу между качеством и задержкой. Дополнительные сведения см . в разделе «Укажите, как и если включать данные о трафике» .
Установите курс транспортного средства (направление движения) и информацию о обочине дороги для путевых точек, чтобы повысить точность расчетного времени прибытия. Подробную информацию см. в разделе «Указание курса транспортного средства и стороны дороги» .
Укажите транзитные и конечные местоположения и безопасные места остановки. Подробные сведения см. в разделах Установка остановки на маршруте и Установка точки для прохождения маршрута .
Запросите информацию о платных дорогах, а также расстояние маршрута и расчетное время прибытия. Подробную информацию см. в разделе Расчет платы за проезд по маршруту .
Контролируйте задержку и качество, запрашивая только те данные, которые вам нужны, с помощью маски поля, что помогает избежать ненужного времени обработки и более высоких ставок оплаты з�� запросы. Подробности см. в разделе Выбор информации для возврата .
Получить матрицу возможных маршрутов
Метод Routes API Compute Route Matrix
предоставляет матрицу информации для рекомендуемых маршрутов между несколькими начальными и конечными точками, включая расстояние и расчетное время прибытия, чтобы помочь вам выбрать лучшие пункты отправления и назначения в соответствии с потребностями вашего бизнеса. Вы можете запросить следующие виды данных о расстоянии:
Расстояние для выбранного режима движения
Расстояние в километрах или милях
Примерное время в пути в пробке
Используя данные о расстоянии, вы можете определить наиболее эффективный способ маршрутизации пассажиров, грузов или работников между несколькими возможными пунктами отправления и назначения.
Вы можете передавать элементы ответа до того, как будет рассчитана вся матрица, что снижает задержку ответа.
Вы можете указать несколько источников и пунктов назначения для каждого запроса на стороне сервера, умножив количество источников на количество пунктов назначения до 625.
Как работает API маршрутов
API Routes имеет два метода: ComputeRoutes
и ComputeRouteMatrix
.
Вычислительные маршруты
Метод ComputeRoutes
API Routes принимает запрос HTTP POST с телом запроса JSON, содержащим сведения о запросе. Обязательными являются происхождение, пункт назначения, travelMode и маска поля, чтобы указать, какие поля возвращать.
Пример
curl -X POST -d '{ "origin": { "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043" }, "destination": { "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Затем служба вычисляет запрошенный маршрут и возвращает запрошенные вами поля.
ВычислитьМаршрутМатрица
API маршрутов ComputeRouteMatrix
принимает запрос HTTP POST с телом запроса JSON, содержащим сведения о запросе. Обязательными являются как минимум один пункт отправления, два или более пункта назначения, режим путешествия и маска поля, чтобы указать, какие поля возвращать.
Пример
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
Ответ содержит возможные маршруты для комбинации всех путевых точек отправления и назначения.
Ресурсы
В следующей таблице приведены ресурсы, доступные через API маршрутов, а также возвращаемые данные.
Ресурсы данных | Данные возвращены | Формат возврата |
---|---|---|
Вычислительные маршруты | Возвращает маршруты, этапы и шаги для маршрута, а также альтернативные маршруты, если это необходимо. | JSON |
ВычислитьМаршрутМатрица | Возвращает массив маршрутов от одной точки отправления до одной точки назначения. |
Как использовать API маршрутов
1 | Настроить | Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке. |
2 | Рассчитайте маршрут и просмотрите ответ | Дополнительные сведения см. в разделах «Получение маршрута» и «Просмотр ответов маршрута» . |
3 | Рассчитайте матрицу маршрутов и просмотрите ответ | Дополнительные сведения см. в разделах Получение матрицы маршрутов и Просмотр ответа матрицы маршрутов . |
Доступные клиентские библиотеки
Список доступных клиентских библиотек для Routes API см. в разделе Клиентские библиотеки .