Как создать поездку и получить токен поездки

Чтобы безопасно запустить пошаговую навигацию для водителя, ваш сервер должен создать поездку и получить токен аутентифицированной поездки от Navigation Connect API.

В Navigation Connect поездка представляет собой сеанс навигации к одному пункту назначения. Чтобы создать поездку и получить токен аутентификации (authToken), необходимый для авторизации сеанса, отправьте сообщение CreateTripRequest в метод CreateTrip. Передайте токен поездки в мобильное приложение, чтобы включить его в URL запуска Google Карт или Waze.

В этом руководстве описывается, как сгенерировать уникальный идентификатор поездки и отправить запрос к API.

Создать сообщение на языке "CreateTripRequest"

Чтобы создать поездку и получить токен поездки, выполните следующие действия по созданию и отправке сообщения CreateTripRequest:

  1. Аутентификация. Используйте Application Default Credentials (ADC), чтобы получить токен доступа для авторизации запроса. Подробнее о том, как создать токен OAuth…
  2. Сгенерируйте идентификатор поездки. Создайте уникальный идентификатор поездки (tripId) в формате UUIDv4, чтобы идентифицировать поездку на сервере.
  3. Создайте полезную нагрузку. Создайте полезную нагрузку JSON, которая включает идентификаторы приложений и настройки конфигурации.
  4. Вызовите метод 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

Чтобы получать ломаную линию активного маршрута и информацию о загруженности дорог в реальном времени, задайте для config.enableRemainingRouteReporting значение true.

Водителям потребуется Waze версии 5.20.0.2 или более поздней на Android, 5.20.0.1 или более поздней на iOS или Google Карты для Android версии 26.27 или более поздней.

Отчеты об отклонении от маршрута (только Waze) boolean

Чтобы отслеживать, когда водитель отклоняется от маршрута, задайте для параметра config.enableRouteDeviationReporting значение true.

У водителей должна быть установлена версия Waze 5.22 или более поздняя.

Частота обновления данных о поездках boolean

По умолчанию Navigation Connect обновляет данные о поездке каждые 60 секунд. Чтобы включить высокую частоту обновления (каждые 5 секунд), задайте для параметра config.enableHighFrequencyUpdates значение true.

Генерация событий Google Cloud Pub/Sub boolean

Чтобы включить создание событий поездок с помощью Google Cloud Pub/Sub, задайте для config.enablePubsub значение true. По умолчанию она отключена.

Маска поля Google Cloud Pub/Sub FieldMask

Чтобы управлять размером полезной нагрузки и снизить нагрузку на серверную часть или расходы на использование Google Cloud Pub/Sub, используйте config.pubsubFieldMask, чтобы исключить тяжелые поля (например, execution.remainingRoute) из потока событий. Дополнительную информацию о размере полезной нагрузки для оставшихся данных маршрута см. в разделе Обработка оставшихся данных маршрута.

Получите токен поездки из ответа

Метод 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