Cuando usas el uso compartido del recorrido de Fleet Engine para viajes on demand, los consumidores pueden realizar el seguimiento del progreso de un pedido, un viaje o algún otro servicio que les proporciones.
¿Qué es compartir recorridos?
La función para compartir viajes es una función de Fleet Engine para viajes a pedido que se usa en SDK para consumidores. Proporciona interfaces que modelan datos de viajes y siguen los viajes en Fleet Engine, y proporciona clases que puedes usar para crear un entorno visualización basada en mapas para brindar información sobre viajes a los usuarios consumidores. Integras el SDK en tu app y establece los perfiles de rol adecuados en Fleet Engine para apoyar el uso que los consumidores hacen de los recorridos compartidos.
El recorrido compartido proporciona APIs específicas de la plataforma para que puedas crear recorridos de forma nativa en tus aplicaciones. El SDK del consumidor está disponible para la las siguientes plataformas:
¿Por qué usar el recorrido compartido?
Al integrar la función para compartir viajes en tus aplicaciones de viajes a pedido, puedes brindan una experiencia de supervisión integral del vehículo, con datos casi en tiempo real actualizaciones de ubicación y posiciones ajustadas a la ruta. Tu los consumidores pueden ver la ruta del vehículo superpuesta en un mapa, incluso detalles del progreso que los ayuden a comprender dónde se encuentra el viaje o la entrega
¿Qué puedes hacer con la opción para compartir el recorrido?
Puedes usar información del SDK de Driver y Fleet Engine para crear datos Vistas del SDK para dispositivos móviles y respuestas de servicios web que proporcionan las siguientes funciones:
Ofrece personalizaciones de la IU del mapa que se ajusten a tus necesidades de desarrollo de la marca.
La ubicación actual del vehículo a medida que se desplaza en la ruta, con su posición se actualiza periódicamente.
La hora estimada de llegada (ETA) para las ubicaciones de partida y llegada.
La distancia restante.
Tráfico en tiempo real de la ruta.
Cómo funciona compartir viajes
En términos generales, los recorridos compartidos se basan en los siguientes mecanismos:
- Roles de usuario adecuados de Fleet Engine para que los usuarios autenticados de la app puedan recuperar el viaje asociado a su pedido.
- Una asociación entre el consumidor y el viaje, proporcionada por tu de backend.
- El SDK de consumidor
TripModelyJourneySharingSession, clases de SDK que modelar datos de viajes y compartir sesiones de viajes en la aplicación para consumidores.
El SDK para consumidores también proporciona otras interfaces y clases para que puedas crear una interfaz de usuario de asignación para tu app, de modo que tus consumidores tengan una experiencia de app enriquecida y completa con detalles como el tráfico, los marcadores del mapa, la hora de llegada estimada y los datos de ruta.
En esta tabla, se muestra el flujo de un recorrido compartido.
| 1 | La app para consumidores solicita un viaje. | Tu servidor de backend recibe una solicitud de viaje a pedido y hace
lo siguiente:
|
| 2 | El conductor acepta el viaje | La app del conductor obtiene el ID y la información del viaje, acepte el viaje. |
| 3 | La app para consumidores solicita acceso al recorrido | La app para consumidores obtiene el ID de viaje del backend solicitudes para comenzar a compartir recorridos. |
| 4 | El conductor inicia el viaje | Si el conductor utiliza la app para conductores para indicar que el viaje finalizó iniciada, la app notifica a tu servidor de backend a través del SDK del controlador. Por ejemplo, si el conductor está a punto de salir del restaurante o conducir al lugar de recogida. |
| 5 | Fleet Engine comienza a compartir el viaje | Fleet Engine comienza a hacer un seguimiento del viaje y a compartir su progreso con la aplicación para consumidores. |
| 6 | La app para consumidores muestra el recorrido | La app para consumidores notifica al consumidor y comienza a mostrar la recorrido hacia él y actualizando el recorrido a medida que avanza. |
| 7 | Se completó o canceló el viaje | Cuando el conductor cancela o completa el viaje, la app del controlador inhabilita el seguimiento de la ubicación, y tu servidor backend le indica a Fleet Engine que marque el viaje como cancelado o completado. |
| 8 | La app para consumidores deja de compartir el recorrido | El recorrido se muestra como cancelado o completado. |
| 9 | El proceso se repite para el próximo viaje. | Se crea un nuevo viaje y el proceso se repite. |
Cómo usar la función para compartir viajes
Selecciona tu plataforma para ver cómo comenzar a compartir recorridos.
Android
| 1 | Cómo configurar el SDK para consumidores en Android | Si quieres compartir recorridos para viajes on demand en tu app, configura el SDK para consumidores. Para obtener más información, consulta Cómo obtener el SDK para consumidores de Android. |
| 2 | Configura la interfaz visual para compartir recorridos | Define un mapa y agrega compatibilidad con mapas de vectores para configurar la interfaz de tu recorrido. Para obtener más información, consulta Configurar un mapa. |
| 3 | Comparte un viaje | Realiza un viaje para compartir la ubicación del vehículo apropiado con tus consumidores. Para obtener más información, consulta Cómo seguir un viaje. |
| 5 | Actualiza el progreso del viaje y controla los errores | Actualiza los detalles del recorrido de tu viaje, como la distancia y la hora estimada de llegada, y controla cualquier error que haya durante ese viaje. Para obtener más información, consulta Actualiza el progreso del viaje y Soluciona los errores de los viajes. |
| 5 | Cuando finalice un recorrido, deje de compartirlo | Deja de seguir un viaje para dejar de compartir la ubicación de un vehículo con tu consumidor. Para obtener más información, consulta Cómo dejar de seguir un viaje. |
iOS
| 1 | Cómo configurar el SDK para consumidores en iOS | Si quieres compartir recorridos para viajes on demand en tu app, configura el SDK para consumidores. Si quieres obtener más información, consulta Cómo obtener el SDK para consumidores de iOS. |
| 2 | Configura la interfaz visual para compartir recorridos | Inicializa la vista de mapa y controla los eventos del mapa para configurar la interfaz de tu viaje. Para obtener más información, consulta Configurar un mapa. |
| 3 | Comparte un viaje | Realiza un viaje para compartir la ubicación del vehículo apropiado con tus consumidores. Para obtener más información, consulta Cómo seguir un viaje. |
| 5 | Actualiza el progreso del viaje y controla los errores | Actualiza los detalles del recorrido de tu viaje, como la distancia y la hora estimada de llegada, y controla cualquier error que haya durante ese viaje. Para obtener más información, consulta Actualiza el progreso del viaje y Soluciona los errores de los viajes. |
| 5 | Cuando finalice un recorrido, deje de compartirlo | Deja de seguir un viaje para dejar de compartir la ubicación de un vehículo con tu consumidor.Para obtener más información, consulta Cómo dejar de seguir un viaje. |
JavaScript
| 1 | Configura la función para compartir recorridos en JavaScript | Si quieres compartir recorridos para viajes on demand en tu app, configura el SDK para consumidores. Para obtener más información, consulta Configura el SDK de consumidor de JavaScript. |
| 2 | Carga y personaliza el mapa para compartir el recorrido | Habilita la API de Maps JavaScript y configura la autorización para configurar la interfaz de tu recorrido. Para obtener más información, consulta Configurar un mapa. |
| 3 | Comparte un viaje | Realiza un viaje para compartir la ubicación del vehículo apropiado con tus consumidores. Para obtener más información, consulta Cómo seguir un viaje. |
| 5 | Actualiza el progreso del viaje y controla los errores | Actualiza los detalles del recorrido de tu viaje, como la distancia y la hora estimada de llegada, y controla cualquier error que haya durante ese viaje. Para obtener más información, consulta Actualiza y sigue el progreso del viaje y Soluciona los errores de los viajes. |
| 5 | Cuando finalice un recorrido, deje de compartirlo | Deja de seguir un viaje para dejar de compartir la ubicación de un vehículo con tu consumidor. Para obtener más información, consulta Cómo dejar de compartir el recorrido. |
Componentes
En esta sección, se resumen dos componentes necesarios para compartir un recorrido:
También puedes personalizar tu experiencia para compartir viajes con estas componentes:
Recuperador de tokens de autenticación
Para controlar el acceso a los datos de ubicación almacenados en Fleet Engine, debes hacer lo siguiente: lo siguiente:
Implementa un servicio de creación de token web JSON (JWT) para Fleet Engine en tu servidor.
Implementa un recuperador de tokens de autenticación en tus apps web o para dispositivos móviles para autenticar el acceso a los datos de ubicación.
Para para obtener más información, consulta la guía de configuración de Android iOS o JavaScript.
Vista de mapa y herramientas de seguimiento de viajes
El recorrido compartido incluye componentes para la visualización de vehículos y puntos de referencia, así como feeds de datos sin procesar para la hora de llegada estimada del conductor o la distancia restante para conducir.
En la siguiente tabla, se describen estos componentes:
| Componente | Descripción |
|---|---|
| Vista de mapa para compartir viajes | La vista de mapa administra el ciclo de vida de un viaje y muestra los puntos de referencia. de la ubicación de los vehículos a medida que avanza el viaje. Si se conoce la ruta de un vehículo, la vista de mapa actualiza la ruta polilínea para indicar el progreso del vehículo a lo largo de su ruta. |
| Proveedor de ubicación de viajes en JavaScript | En el caso de las aplicaciones web de JavaScript, el proveedor de la ubicación de viajes alimenta la ubicación
de los objetos rastreados en el mapa de recorrido compartido. Para ver más
información, consulta
Crea una instancia de un proveedor de ubicación de viajes.
Puedes usar el proveedor de ubicación de viajes para realizar un seguimiento de los siguientes detalles de una
viaje:
|
Objetos de ubicación con seguimiento
El proveedor de ubicación realiza un seguimiento de la ubicación de los objetos como los puntos de referencia y como los que se describen en la siguiente tabla.
| Ubicación con seguimiento | Descripción |
|---|---|
| Lugar de recogida | El lugar de partida es el lugar donde comienza un viaje. Marca el lugar de recogida. |
| Ubicación de destino | La ubicación de destino es la ubicación donde termina un viaje. Marca la ubicación de destino. |
| Ubicación del punto de referencia | Una ubicación de punto de referencia es cualquier ubicación intermedia a lo largo de la ruta de un recorrido. Si bien, técnicamente, los puntos de referencia pueden incluir los puntos de partida y destino, los puntos de referencia suelen referirse a rutas paradas a lo largo de la ruta. Por ejemplo, las paradas entre los puntos de partida y destino en una ruta de entrega son ubicaciones de puntos de referencia. Para obtener más información, consulta Puntos de referencia de viaje en la documentación de Fleet Engine. |
| Ubicación del vehículo | La ubicación del vehículo es la ubicación que se informa de un vehículo. Para ver más consulta Ubicación del vehículo en la documentación de Fleet Engine. |
Elige un estilo para tus mapas
Los estilos de marcador y polilínea determinan el aspecto de la objetos de ubicación rastreados en el mapa. Puedes usar opciones de diseño personalizadas para cambiar el estilo predeterminado de modo que coincida con el estilo de tu aplicación web.
Controlar la visibilidad de las ubicaciones que sigues
Los proveedores de ubicación predefinidos en Fleet Engine siguen estas reglas de visibilidad para los objetos de ubicación rastreados en el mapa. Si creas una canalización personalizada proveedor de ubicación, puedes cambiar las reglas de visibilidad.
Los vehículos son visibles solo cuando el viaje está en curso: Un viaje. el vehículo compartido es visible desde el momento en que se asigna a un viaje al la hora de llegada. Si se cancela el viaje, el vehículo ya no estará visible.
Todos los demás marcadores de ubicación estarán siempre visibles: Todos los demás marcadores de ubicación. para origen, destino y puntos de referencia se muestran siempre en el mapa. Para por ejemplo, un viaje en el que se comparte la ubicación de llegada o una entrega ubicación siempre se muestra en el mapa, independientemente del estado de la viaje o entrega.
¿Qué sigue?
Consulta la documentación de la plataforma en la que deseas compartir recorridos: