Descripción general de la API de Navigation Connect

Desarrolladores del Espacio Económico Europeo (EEE)

La API de Navigation Connect es un servicio que conecta el uso que hace tu conductor de la navegación de Google Maps y Waze con tus sistemas empresariales. Utiliza tokens de autorización de viaje junto con un vínculo directo en tu app, de modo que el conductor pueda presionar un vínculo o botón para comenzar la navegación en la aplicación para consumidores que elija. Mientras el conductor navega durante el viaje, puedes recibir datos de ubicación en tiempo real continuos, como ubicaciones en vivo, horas de llegada estimadas muy precisas y estados del ciclo de vida del viaje.

La API de Navigation Connect ofrece una alternativa liviana al SDK de Navigation, ya que usa las apps independientes de Google Maps y Waze para la generación de rutas en lugar de requerir que compiles y que incorpores una interfaz de navegación personalizada en tu app. Vincula de forma segura la sesión del conductor a tu backend. Cuando un conductor inicia un viaje, ve la interfaz de navegación familiar con dos agregados: un mensaje de consentimiento para compartir los datos del viaje (que se requiere cada 12 meses) y un botón Atrás con la marca para volver a tu app.

Por qué usar la API de Navigation Connect

Con la API de Navigation Connect, puedes integrar actualizaciones en tiempo real de la ubicación del viaje y la ETA de Google Maps o Waze directamente en tus procesos de backend. Esto te ayuda a tomar decisiones comerciales importantes y compartir actualizaciones precisas con tus clientes, mientras que los conductores usan su app de navegación preferida, Google Maps o Waze.

Estos son algunos ejemplos de casos de uso:

  • Aumenta la transparencia del uso compartido de viajes: Proporciona a los clientes y pasajeros de viajes compartidos actualizaciones precisas y en tiempo real sobre la ubicación de su conductor y las horas de llegada estimadas.
  • Mejora el seguimiento de entregas: Informa a los clientes sobre los horarios precisos de entrega de envíos o alimentos según los datos de tráfico en tiempo real y rutas.
  • Mejora la administración y el envío de flotas: Toma decisiones fundamentadas sobre el envío de flotas o fuerzas laborales móviles que brindan servicios a pedido (como asistencia en caso de averías, mantenimiento o transporte) haciendo un seguimiento de las ubicaciones de los conductores en tiempo real.

Qué puedes hacer con la API de Navigation Connect

La API de Navigation Connect te permite recibir actualizaciones de ubicación y ETA en tiempo real de Google Maps o Waze directamente en tu backend.

  • Realiza un seguimiento de los viajes de forma no intrusiva: Realiza un seguimiento de los viajes sin cambiar la opción del conductor de usar Google Maps o Waze, ni modificar su experiencia del usuario.
  • Accede a datos de ubicación en tiempo real: Obtén las ubicaciones de los conductores en tiempo real, las distancias restantes y el tiempo transcurrido de forma continua durante un viaje.
  • Supervisa los ciclos de vida de los viajes: Configura la frecuencia de actualización de los datos de los viajes para hacer un seguimiento del estado exacto de un viaje y saber de inmediato cuándo un conductor está en camino, llegó o suspendió un viaje.
  • Consultar y compartir las horas de llegada estimadas: Recupera actualizaciones de las horas de llegada estimadas muy precisas gracias a los algoritmos de rutas en tiempo real de Google.
  • Hacer un seguimiento de la ruta y el tráfico restantes (solo en Waze): Recibe la polilínea de la ruta restante y las condiciones de tráfico en tiempo real desde la ubicación actual del conductor hasta su destino final, exactamente como se muestran en Waze.
    • Recorte dinámico: A medida que el vehículo se mueve, Navigation Connect recorta automáticamente la polilínea de la ruta activa del conductor (la ruta completa por la que se navega actualmente en la app) para garantizar que solo recibas la ruta restante (el tramo desde la posición actual del conductor hasta el destino).
    • Frecuencia de actualización: Las rutas y las condiciones de tráfico se actualizan automáticamente cuando se vuelve a calcular la ruta, se realiza un cambio de ruta proactivo del cliente o cambian las condiciones de tráfico.
  • Transfiere datos de forma flexible: Consume datos de viajes en tiempo real con llamadas directas a la API de REST o transmite actualizaciones de manera eficiente con suscripciones a Google Cloud Pub/Sub.

Cómo funciona la API de Navigation Connect

La API de Navigation Connect acepta una solicitud CreateTrip que contiene los identificadores de tu aplicación para dispositivos móviles y la configuración de la sesión. El servicio genera una instancia de viaje única y devuelve un token de viaje. Luego, este token se agrega a un vínculo directo de Google Maps o Waze. Una vez que el conductor inicia la navegación y otorga su consentimiento, el servicio procesa los datos de navegación en tiempo real y devuelve actualizaciones de telemetría, como la ubicación, la ETA y la distancia restante.

Recursos

En la siguiente tabla, se resumen los recursos disponibles a través de la API de Navigation Connect junto con los datos que devuelve. Para obtener detalles específicos, consulta la referencia de la API de Navigation Connect.

Recursos de datos Datos devueltos

Identificadores de autenticación y de apps para dispositivos móviles en formato JSON.

Consulta Crea un viaje.

Es un token de viaje único que se usa para inicializar la conexión en Google Maps o Waze.

Consulta Cómo iniciar Google Maps o Waze.

El ID de viaje único y un método de extracción o inserción en formato JSON.

Consulta Cómo recuperar datos de viajes.

Telemetría de viajes en tiempo real, que incluye lo siguiente:

  • Estado y metadatos del viaje
  • Ubicación actual (latitud y longitud)
  • Hora estimada de llegada (ETA)
  • Distancia y tiempo restantes

Consulta Cómo controlar los datos de viajes.

Cómo usar la API de Navigation Connect

1 Inicia la configuración Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones que se indican a continuación.
2 Cómo crear un viaje Envía una llamada a la API de Navigation Connect para crear un viaje con un ID único y guarda el token.
3 Inicia Google Maps o Waze Pasa el token de viaje y lanza Google Maps o Waze para habilitar el uso compartido de datos de viajes.
4 Cómo recuperar datos de viajes Envía una llamada a la API de Navigation Connect para recuperar datos de viajes. De manera opcional, suscríbete a las actualizaciones con Google Cloud Pub/Sub.
5 Cómo controlar los datos del viaje Comprende cómo controlar el estado del viaje y otros datos del viaje.