Crea un viaje y obtén un token de viaje

Para iniciar una sesión de navegación paso a paso de forma segura para un conductor, tu backend debe crear un viaje y obtener un token de viaje autenticado de la API de Navigation Connect.

En Navigation Connect, un viaje representa una sesión de navegación a un solo destino. Para crear un viaje y obtener el token de viaje autenticado (authToken) necesario para autorizar la sesión, envía un mensaje CreateTripRequest al método CreateTrip. Pasa el token de viaje a tu app para dispositivos móviles para incluirlo en la URL de inicio de Google Maps o Waze.

En esta guía, se describe cómo completar este proceso generando un ID de viaje único y enviando tu solicitud a la API.

Crea un mensaje CreateTripRequest

Para crear un viaje y obtener un token de viaje, sigue estos pasos para construir y enviar un mensaje CreateTripRequest:

  1. Autentica: Usa las credenciales predeterminadas de la aplicación (ADC) para obtener un token de acceso que autorice tu solicitud. Para obtener más detalles, consulta Crea un token de OAuth.
  2. Genera un ID de viaje: Crea un ID de viaje único (tripId) en formato UUIDv4 para identificar el viaje en tu servidor.
  3. Crea la carga útil: Crea una carga útil JSON que incluya los IDs de tu app y los parámetros de configuración.
  4. Llama al método CreateTrip: Envía una solicitud POST a la API con el token de acceso en el encabezado y la carga útil en el cuerpo.

En el siguiente ejemplo, se muestra cómo crear un viaje enviando un mensaje 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}"

Configuración opcional

Puedes personalizar los datos del viaje ajustando los siguientes parámetros de configuración en el mensaje CreateTripRequest:

Función Tipo Descripción
Informes de rutas restantes boolean

Para recibir la polilínea de la ruta activa y las condiciones de tráfico en tiempo real, establece config.enableRemainingRouteReporting en true.

Los conductores necesitan la versión 5.20.0.2 o posterior de Waze en Android, la versión 5.20.0.1 o posterior en iOS, o la versión 26.27 o posterior de Google Maps para Android.

Informes de desvío de ruta (solo en Waze) boolean

Para hacer un seguimiento de cuándo un conductor se desvía de la ruta, configura config.enableRouteDeviationReporting como true.

Los conductores necesitan la versión 5.22 o posterior de Waze.

Frecuencia de actualización de los viajes boolean

De forma predeterminada, Navigation Connect actualiza los datos del viaje cada 60 segundos. Para habilitar las actualizaciones de alta frecuencia (cada 5 segundos), establece config.enableHighFrequencyUpdates en true.

Generación de eventos de Google Cloud Pub/Sub boolean

Para habilitar la generación de eventos de viaje con Google Cloud Pub/Sub, establece config.enablePubsub en true. Esta función se inhabilita de forma predeterminada.

Máscara de campo de Google Cloud Pub/Sub FieldMask

Para administrar los tamaños de las cargas útiles y reducir la carga de procesamiento del backend o los costos de uso de Google Cloud Pub/Sub, usa config.pubsubFieldMask para excluir los campos pesados (como execution.remainingRoute) de tu flujo de eventos. Para obtener más información sobre el tamaño de la carga útil de los datos de la ruta restante, consulta Cómo controlar los datos de la ruta restante.

Obtén el token de viaje de la respuesta

El método CreateTrip devuelve una respuesta que contiene el token de viaje autenticado. Para autorizar la sesión de navegación, extrae este token de la respuesta y pásalo a tu app para dispositivos móviles para que lo incluya en la URL de inicio.

En la siguiente muestra de código, se incluye una respuesta de ejemplo:

{
    "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"
}

Esta respuesta incluye los siguientes valores:

  • PROJECT_NUMBER: Es un identificador numérico único para tu proyecto. Este es distinto de tu ID del proyecto alfanumérico, pero representa el mismo proyecto de Google Cloud.
  • TRIP_ID: Es el ID del viaje que genera tu backend en formato UUIDv4.
  • BASE64_ENCODED_TRIP_TOKEN: Es el token de viaje autenticado (authToken.token) que devuelve el método CreateTrip. Pasa este token a tu app para dispositivos móviles para iniciar la navegación paso a paso con seguimiento en Google Maps o Waze.

¿Qué sigue?

Usa el token de viaje para iniciar Google Maps o Waze.

Cómo iniciar Google Maps o Waze