Configura Navigation Connect

Desarrolladores del Espacio Económico Europeo (EEE)

En este documento, se describen los pasos que debes seguir para comenzar a usar Navigation Connect.

Comprueba que cumples con los requisitos previos.

Activa la API en tu proyecto de Google Cloud.

Configura OAuth para realizar una solicitud a la API autenticada.

Los productos de Google Maps Platform requieren que las llamadas a la API incluyan un token de OAuth para evitar el uso no autorizado.

Crea un token de OAuth

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

En este documento, se describe cómo pasar un token de OAuth a una llamada de Navigation Connect en tu entorno de desarrollo. Para obtener más información sobre el uso de OAuth en un entorno de producción, consulta Métodos de autenticación en Google.

Puedes llamar a las APIs de Google Maps directamente realizando solicitudes a la API al servidor, o bien puedes usar bibliotecas cliente para simplificar tu código. Google Maps proporciona bibliotecas cliente para Go, Java, Node.js y Python. Para obtener más información, consulta Bibliotecas cliente de Navigation Connect.

Descripción general de OAuth

Puedes crear y administrar tokens de acceso con OAuth de varias maneras, según tu entorno de implementación.

Puedes usar OAuth 2.0 para las interacciones de servidor a servidor entre tu aplicación y un servicio de Google. En este caso, usarás una cuenta de servicio asociada a tu aplicación en lugar de un usuario individual. Puedes realizar solicitudes a la API con la cuenta de servicio sin involucrar a los usuarios directamente. Para obtener más información sobre los métodos de autenticación, consulta Métodos de autenticación en Google.

Como alternativa, puedes integrar Navigation Connect en una app para dispositivos móviles de Android o iOS. Para obtener más información sobre cómo usar OAuth y administrar tokens de acceso para diferentes entornos de implementación, consulta Usa OAuth 2.0 para acceder a las APIs de Google.

Alcances de OAuth

Para usar OAuth con Navigation Connect, debes asignar al token de OAuth el siguiente permiso:

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

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

Si no tienes un entorno que genere tokens y quieres probar Navigation Connect con un token de OAuth, sigue el procedimiento que se describe en esta sección.

En este ejemplo, se describe cómo usar el token de OAuth proporcionado por las credenciales predeterminadas de la aplicación (ADC) para realizar la llamada. Si deseas obtener más información para usar ADC para llamar a las APIs de Google con bibliotecas cliente, consulta Autentícate con bibliotecas cliente.

Usa el siguiente procedimiento de REST solo para desarrollo o pruebas, no para producción.

Requisitos previos

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

  1. Instala e inicializa la CLI de gcloud Para obtener más información, consulta Instala gcloud CLI.

  2. Autentica con la CLI de gcloud:

    gcloud auth application-default login

  3. Completa el proceso de acceso para guardar tus credenciales en el archivo de credenciales local que usa ADC.

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

Cómo realizar una solicitud de 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 devuelve tiene un alcance 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 encabezado X-Goog-User-Project.

Para llamar a Navigation Connect con un token de OAuth, completa los siguientes pasos:

  1. En la siguiente muestra de código, reemplaza los marcadores de posición por tus valores:

    • PROJECT_ID: El ID del proyecto de Google Cloud.
    • ANDROID_APP_ID: Es el nombre del paquete de Android de tu app, si corresponde.
    • IOS_APP_ID: El ID del paquete de iOS de tu app, si corresponde
    #!/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. Para copiar el comando curl, haz clic en Copiar en la muestra de código.

  3. Pega el comando en una ventana de terminal y, luego, 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 UUIDv4 que genera tu backend.
  • BASE64_ENCODED_TRIP_TOKEN: Es el token autenticado que devuelve el método createTrip para iniciar la navegación paso a paso con seguimiento en Google Maps o Waze.

Solución de problemas

Si tu solicitud muestra un mensaje de error que indica que esta API no admite credenciales de usuario final, consulta Soluciona problemas de la configuración de ADC.

¿Qué sigue?

A continuación, configura tus cuentas de servicio para la API de Navigation Connect de modo que admitan la comunicación segura de servidor a servidor entre tu infraestructura de backend, Google Maps y Waze.

Configura tu cuenta de servicio