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.

Requisitos previos

En esta guía, se muestra cómo configurar tu cuenta de Google Cloud y tu proyecto de Google Cloud con la facturación habilitada. También debes conocer cómo se te cobra por usar la API de Navigation Connect.

  1. Revisa la facturación y el costo del uso en Navegación, Uso y facturación de Connect.
  2. Verifica que tengas una Cuenta de Google Cloud.

    Accede a la consola de Google Cloud
  3. Verifica que tengas un proyecto de Google Cloud con la facturación habilitada.

    Ir a la página Facturación
    1. Selecciona tu proyecto para abrir la página Facturación.
    2. En la página Facturación, haz lo siguiente:

      • Si la facturación ya está habilitada para el proyecto seleccionado y solo tienes una cuenta de facturación, se abrirá la página Facturación.
      • Si tienes varias cuentas de facturación, selecciona Ir a la cuenta de facturación vinculada para ver los detalles de la cuenta de facturación asociada con el proyecto.
      • Si existe una cuenta de facturación, pero no está asociada al proyecto, se te solicitará que vincules una cuenta de facturación con el proyecto.
      • Si no existe una cuenta de facturación o quieres crear una nueva, selecciona Administrar cuentas de facturación para crear una nueva. Para obtener más información, consulta Crea una nueva cuenta de Facturación de Cloud de servicio automático.

Habilita la API y verifica tu app

En esta guía, se describe el proceso para habilitar la API de Navigation Connect y verificar tu app en la consola de Google Cloud, lo que permite que tu app interactúe de forma segura con Google Maps y Waze. Debes completar este proceso para usar la API de Navigation Connect.

1. Habilita la API de Navigation Connect

Usa la consola de Google Cloud o el comando gcloud para habilitar la API de Navigation Connect en tu proyecto de Google Cloud.

Para habilitar la API, sigue estos pasos:

Console

  1. Abre la página del producto en la consola de Google Cloud:

    Habilita la API de Navigation Connect
  2. Haz clic en el botón Habilitar.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "navigationconnect.googleapis.com"

Obtén más información sobre el SDK de Google Cloud, la instalación del SDK de Cloud y los siguientes comandos:

2. Inicia el proceso de verificación de la app

Después de habilitar la API, debes verificar tu app para activar la API de Navigation Connect. Habilitar la API por sí sola no otorga acceso. Debes proporcionar detalles de la empresa y de la app para su revisión antes de poder usar la API de Navigation Connect.

Para iniciar el proceso de verificación, usa uno de los siguientes métodos:

  • Marketplace de APIs:
    1. En Marketplace de APIs, busca la tarjeta API de Navigation Connect.
    2. Haz clic en el ícono azul Se requiere verificación para iniciar el flujo de verificación.
  • Claves y credenciales en la consola de Google Cloud:
    1. En la consola de Google Cloud, ve a la página Claves y credenciales.
    2. Haz clic en Claves y credenciales de Navigation Connect.
    3. En el banner, haz clic en Comenzar la verificación.

3. Proporciona detalles sobre la app, la recopilación de datos y la privacidad

En la siguiente tabla, se describen los detalles que debes proporcionar para la verificación de la app:

Campo Descripción
Detalles de la app

Proporciona los siguientes detalles para asegurarte de que tu app se muestre correctamente en Google Maps y Waze.

Nombre de la empresa o de la app Ingresa el nombre que se mostrará a los usuarios en Google Maps y Waze.
Identificador de la aplicación Proporciona el nombre del paquete de Android o el ID del paquete de iOS.
Vínculo universal de iOS Proporciona el vínculo universal de iOS que permite a los usuarios volver a tu app (solo disponible en Waze).
Logotipo de la app (solo para Waze) (Opcional) Sube un logotipo en formato PNG o JPG (de 32 × 32 a 128 × 128 píxeles) para mostrar el logotipo de tu app en Waze durante una sesión de navegación.
Detalles sobre la recopilación de datos y la privacidad

Ingresa los siguientes detalles para garantizar la transparencia, la confianza de los conductores y la seguridad de los datos.

Vínculo a la política de privacidad Proporciona la URL de la política de privacidad de tu app. Este vínculo aparece en la pantalla de consentimiento.
Responsables adicionales del tratamiento de datos (opcional) Proporciona el nombre comercial y el vínculo a la política de privacidad de los administradores de datos de terceros, como los ISV. Estos detalles aparecen en la pantalla de consentimiento.
Cumplimiento de los datos Si tu app funciona en Estados Unidos, selecciona la casilla de verificación Esta app se usará para viajes que se realicen en Estados Unidos para garantizar el cumplimiento de las reglamentaciones locales.

4. Revisar y enviar

Revisa el resumen de la información que proporcionaste antes de enviar la app para su verificación.

  1. Revisa cuidadosamente el nombre, la plataforma, los IDs y los vínculos de tu app.

  2. Selecciona la casilla de verificación Toda la información es precisa.
  3. Haz clic en Enviar.

Después de enviar tu app para su verificación, comienza la fase de revisión.

  • Cronograma: La verificación suele tardar entre 1 y 3 días hábiles.
  • Notificación: Recibirás un correo electrónico cuando cambie el estado de verificación. También recibirás un correo electrónico en el que se te solicitará tu ID de perfil de pagos o tu ID de desarrollador de Android. Si necesitas un ID de desarrollador de Android, consulta Cómo crear una cuenta de desarrollador.
  • Seguimiento del estado: Supervisa tu progreso en la página Claves y credenciales de la consola de Google Cloud.
  • Asistencia: Para actualizar tu configuración después de la aprobación sin afectar la producción, crea un ticket de asistencia.

Una vez que se verifique, tu app estará autorizada para usar la API de Navigation Connect y generar tokens de viaje que permitan el acceso a una sesión de navegación y te permitan recibir detalles del viaje de Google Maps y Waze.

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 de 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 con 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 con iOS o Android. Para obtener más información sobre cómo usar OAuth y administrar tokens de acceso en 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 las 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, usa el procedimiento de esta sección.

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. Para obtener más información sobre el uso de 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.

Realiza 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 muestra 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: el identificador de número entero largo único 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 que la API de Navigation Connect admita la comunicación segura de servidor a servidor entre tu infraestructura de backend, Google Maps y Waze.

Configura tu cuenta de servicio