Configura Navigation Connect

Desarrolladores del Espacio Económico Europeo (EEE)

En este documento, se describen los pasos necesarios para comenzar a usar Navigation Connect.

Asegúrate de cumplir con los requisitos previos.

Habilita la API en tu proyecto de Google Cloud.

Configura un OAuth para realizar una solicitud a la API autenticada.

Los productos de Google Maps Platform están protegidos contra un uso no autorizado, ya que requieren que las llamadas a la API incluyan un token de OAuth.

Crea un token de OAuth

Navigation Connect admite el uso de OAuth 2.0 para la autenticación. Google admite situaciones comunes de OAuth 2.0, como las de un servidor web.

En este documento, se describe cómo pasar un token de OAuth a la llamada de Navigation Connect en tu entorno de desarrollo. Si deseas obtener instrucciones para usar OAuth en un entorno de producción, consulta Métodos de autenticación en Google.

Acerca de OAuth

Existen muchas formas de crear y administrar tokens de acceso con OAuth según tu entorno de implementación.

Por ejemplo, el sistema de Google OAuth 2.0 admite interacciones de servidor a servidor, como las que se producen entre tu aplicación y un servicio de Google. Para esta situación, necesitas una cuenta de servicio, que es una cuenta que pertenece a tu aplicación, no a un usuario final individual. Tu aplicación llama a las APIs de Google en nombre de la cuenta de servicio, por lo que los usuarios no están involucrados de manera directa. Para obtener más información sobre los métodos de autenticación, consulta Métodos de autenticación en Google.

Como alternativa, puedes usar Navigation Connect como parte de una app para dispositivos móviles iOS o Android. Para obtener información general sobre el uso de OAuth con Navigation Connect, incluida la administración de tokens de acceso para diferentes entornos de implementación, consulta Usa OAuth 2.0 para acceder a las APIs de Google.

Acerca de los permisos de OAuth

Para usar OAuth con Navigation Connect, el token de OAuth debe tener asignado el siguiente permiso:

https://www.googleapis.com/auth/cloud-platform

Ejemplo: Prueba las llamadas a la API de REST en tu entorno de desarrollo local

Si quieres probar Navigation Connect con un token de OAuth, pero no tienes una configuración de entorno para generar tokens, puedes usar el procedimiento de esta sección para realizar la llamada.

En este ejemplo, se describe cómo usar el token de OAuth que proporcionan las credenciales predeterminadas de la aplicación (ADC) para realizar la llamada. Si deseas obtener información sobre el uso de ADC para llamar a las APIs de Google mediante bibliotecas cliente, consulta Autentícate mediante bibliotecas cliente.

Requisitos previos

Antes de realizar una solicitud REST con ADC, usa Google Cloud CLI para proporcionar credenciales a ADC:

  1. Instala e inicializa gcloud CLI.

  2. Ejecuta el siguiente gcloud comando en tu máquina local para crear tu archivo de credenciales:

    gcloud auth application-default login
  3. Se muestra una pantalla de acceso. Después de acceder, tus credenciales se almacenan en el archivo de credenciales local que usa ADC.

Para obtener más información, consulta Configura ADC para un entorno de desarrollo local.

Realiza una solicitud REST

En este ejemplo, pasas dos encabezados de solicitud:

  • Pasa el token de OAuth en el encabezado Authorization con el siguiente comando para generar el token:

    gcloud auth application-default print-access-token

    El token que se muestra tiene un permiso de https://www.googleapis.com/auth/cloud-platform.

  • Pasa el ID o el nombre de tu proyecto de Google Cloud que tiene habilitada la facturación en el X-Goog-User-Project encabezado.

En el siguiente ejemplo, se realiza una llamada a Navigation Connect con un token de OAuth.

  1. Edita el campo PROJECT_ID para pasar el ID de tu proyecto de Google Cloud.

    También edita lo siguiente, según corresponda:

    • ANDROID_APP_ID: Es el nombre del paquete de Android de tu app.
    • IOS_APP_ID: Es el ID de paquete de iOS de tu app.
    #!/bin/bash

trip_id="$(uuidgen)"
access_token="$(gcloud auth application-default print-access-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 '{
  "androidAppId": "ANDROID_APP_ID",
  "iosAppId": "IOS_APP_ID",
}'
  2. Haz clic en el ícono de copia en la muestra de código, Selecciona el ícono de copiar., para copiar el curl comando.
  3. Pega el comando en una ventana de la terminal y ejecútalo.

La respuesta es un objeto JSON:

{
  "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 el identificador único de número entero largo del proyecto.
  • TRIP_ID: Es el ID de viaje que genera tu backend en formato UUIDv4.
  • BASE64_ENCODED_TRIP_TOKEN: Es el token autenticado que muestra 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.

Solución de problemas

Si en la solicitud se muestra un mensaje de error sobre la compatibilidad de las credenciales del usuario final con esta API, consulta Soluciona problemas de la configuración de ADC.

¿Qué sigue?

El siguiente paso para configurar la API de Navigation Connect es configurar tus cuentas de servicio para habilitar la comunicación segura de servidor a servidor entre tu infraestructura de backend y Google Maps y Waze.

Configura tu cuenta de servicio