Зачем использовать 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 см. в разделе Клиентские библиотеки .