Descripción general y requisitos de la configuración

En este documento, se explica el proceso para configurar la API de Navigation Connect y se enumeran los requisitos del dispositivo del conductor para usar la API de Navigation Connect.

Proceso de configuración de Navigation Connect

Antes de poder usar la API de Navigation Connect, debes completar los siguientes pasos de configuración:

  1. Crea y configura un proyecto de Google Cloud.
  2. Habilita la API de Navigation Connect y verifica tu app.
  3. Configura OAuth para crear tokens de OAuth.
  4. Configura tu cuenta de servicio para habilitar la comunicación entre tu infraestructura de backend y Google Maps o Waze.

Requisitos mínimos del dispositivo para usar Navigation Connect

Estos requisitos son necesarios para que el dispositivo del conductor ejecute correctamente una sesión de Navigation Connect. Una sesión usa la API de Navigation Connect para enviar datos de viaje en tiempo real, como la ubicación y la hora estimada de llegada, a tu servidor de backend.

Versiones de la app compatibles

El dispositivo debe tener instalada la app de Waze o Google Maps para Android. En la siguiente tabla, se indica la versión mínima de cada app para Navigation Connect y para las funciones que necesitan una versión posterior.

Aplicación Versión mínima Informes de rutas restantes Informes de desvío de ruta
Waze para Android 5.15.5 5.20.0.2 5.22
Waze para iOS 5.15.5 5.20.0.1 5.22
Google Maps para Android 26.14 26.27 No se permite

Se habilitó la ubicación precisa

Solicita al conductor que active los permisos de ubicación precisa en su dispositivo. Waze y Google Maps requieren la ubicación precisa para comenzar la navegación.

Cuadro de diálogo de consentimiento del conductor.

Navigation Connect requiere el consentimiento del conductor para compartir los datos del viaje. No necesitas activar el cuadro de diálogo de consentimiento, ya que Google Maps o Waze controlan automáticamente esta interfaz de usuario.

En el primer viaje que se inicia desde tu app, Google Maps o Waze le solicita al conductor que comparta sus datos de viaje.

  • Si el conductor presiona Permitir, Navigation Connect comienza a compartir la ubicación en tiempo real y los datos de la hora estimada de llegada con tu backend.
  • Si el conductor presiona No permitir o revoca el consentimiento más adelante, Google Maps o Waze proporcionan instrucciones paso a paso, pero Navigation Connect no envía datos. Tu backend recibe un estado CLIENT_ERROR en la carga útil de los datos del viaje.

Los conductores deben volver a confirmar este consentimiento cada 12 meses.

¿Qué sigue?

El primer paso para configurar la API de Navigation Connect es crear y configurar un proyecto de Google Cloud.