Чтобы безопасно запустить пошаговую навигацию для водителя, ваш сервер должен создать поездку и получить токен аутентифицированной поездки от Navigation Connect API.
В Navigation Connect поездка представляет собой сеанс навигации к одному пункту назначения. Чтобы создать поездку и получить токен аутентификации (authToken), необходимый для авторизации сеанса, отправьте сообщение CreateTripRequest в метод CreateTrip. Передайте токен поездки в мобильное приложение, чтобы включить его в URL запуска Google Карт или Waze.
В этом руководстве описывается, как сгенерировать уникальный идентификатор поездки и отправить запрос к API.
Создать сообщение на языке "CreateTripRequest"
Чтобы создать поездку и получить токен поездки, выполните следующие действия по созданию и отправке сообщения CreateTripRequest:
- Аутентификация. Используйте Application Default Credentials (ADC), чтобы получить токен доступа для авторизации запроса. Подробнее о том, как создать токен OAuth…
- Сгенерируйте идентификатор поездки. Создайте уникальный идентификатор поездки (
tripId) в формате UUIDv4, чтобы идентифицировать поездку на сервере. - Создайте полезную нагрузку. Создайте полезную нагрузку JSON, которая включает идентификаторы приложений и настройки конфигурации.
- Вызовите метод
CreateTrip. Отправьте запрос POST к API с токеном доступа в заголовке и полезной нагрузкой в теле.
В примере ниже показано, как создать поездку, отправив сообщение CreateTripRequest.
#!/bin/bash
# Authenticate with ADC
access_token="$(gcloud auth application-default login --impersonate-service-account=SERVICE_ACCOUNT_EMAIL)"
# Generate a unique Trip ID
trip_id="$(uuidgen)"
# Construct the payload
payload=$(cat <<EOF
{
"androidAppId": "ANDROID_APP_ID",
"iosAppId": "IOS_APP_ID",
"config": {
"enablePubsub": true
}
}
EOF
)
# Call the CreateTrip method to request a trip token
curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json" \
-d "${payload}"
Дополнительные настройки
Вы можете настроить данные о поездке, изменив следующие параметры в сообщении CreateTripRequest:
| Функция | Тип | Описание |
|---|---|---|
| Отчеты об оставшейся части маршрута | boolean |
Чтобы получать ломаную линию активного маршрута и информацию о загруженности дорог в реальном времени, задайте для Водителям потребуется Waze версии 5.20.0.2 или более поздней на Android, 5.20.0.1 или более поздней на iOS или Google Карты для Android версии 26.27 или более поздней. |
| Отчеты об отклонении от маршрута (только Waze) | boolean |
Чтобы отслеживать, когда водитель отклоняется от маршрута, задайте для параметра У водителей должна быть установлена версия Waze 5.22 или более поздняя. |
| Частота обновления данных о поездках | boolean |
По умолчанию Navigation Connect обновляет данные о поездке каждые 60 секунд. Чтобы включить высокую частоту обновления (каждые 5 секунд), задайте для параметра |
| Генерация событий Google Cloud Pub/Sub | boolean |
Чтобы включить создание событий поездок с помощью Google Cloud Pub/Sub, задайте для |
| Маска поля Google Cloud Pub/Sub | FieldMask |
Чтобы управлять размером полезной нагрузки и снизить нагрузку на серверную часть или расходы на использование Google Cloud Pub/Sub, используйте |
Получите токен поездки из ответа
Метод CreateTrip возвращает ответ, содержащий токен аутентифицированной поездки. Чтобы авторизовать сеанс навигации, извлеките этот токен из ответа и передайте его в мобильное приложение для включения в URL запуска.
Ниже приведен пример ответа.
{
"name": "projects/PROJECT_NUMBER/trips/TRIP_ID",
"authToken": {
"token": "BASE64_ENCODED_TRIP_TOKEN",
"expireTime": "2026-03-06T11:09:47.476942Z"
},
"state": "NEW",
"execution": {
"traveledDistanceMeters": 0,
"stopAddedInRoute": false
},
"createTime": "2026-03-05T23:09:50.768959Z",
"updateTime": "2026-03-05T23:09:50.768959Z"
}
Этот ответ содержит следующие значения:
- PROJECT_NUMBER: уникальный числовой идентификатор проекта. Он отличается от буквенно-цифрового идентификатора проекта, но представляет тот же облачный проект Google Cloud.
- TRIP_ID – идентификатор поездки, сгенерированный вашим бэкендом в формате UUIDv4.
- BASE64_ENCODED_TRIP_TOKEN – токен аутентифицированной поездки (
authToken.token), возвращенный методомCreateTrip. Передайте этот токен в мобильное приложение, чтобы запустить отслеживаемую пошаговую навигацию в Google Картах или Waze.
Дальнейшие действия
Используйте токен поездки, чтобы запустить Google Карты или Waze.
Как запустить Google Карты или Waze