Personaliza la experiencia del consumidor para los viajes a pedido permitiéndoles seguir el viaje de un pedido, un viaje o cualquier otro servicio que les proporciones.
¿Qué es el SDK para consumidores?
El SDK para el consumidor es parte de Fleet Engine para viajes a pedido. Proporciona interfaces que modelan los datos de los viajes y los siguen en Fleet Engine, y proporciona clases que usas para crear una visualización enriquecida basada en mapas para compartir viajes con tus usuarios consumidores. Integras el SDK para el consumidor en tu app y estableces los perfiles de roles adecuados en Fleet Engine para crear esta experiencia del consumidor.
Las APIs específicas de la plataforma del SDK para consumidores te permiten crear la capacidad de compartir recorridos de forma nativa en tus aplicaciones. El SDK para consumidores está disponible para las siguientes plataformas:
¿Por qué usar el SDK para consumidores?
La integración del SDK para consumidores en tus aplicaciones de viajes a pedido te permite brindar una experiencia integral al consumidor, con actualizaciones de ubicación casi en tiempo real y posiciones ajustadas a la ruta. Tus consumidores pueden ver la ruta del vehículo superpuesta en un mapa, incluidos los detalles del progreso que los ayudan a comprender dónde se encuentra su viaje o entrega.
¿Qué puedes hacer con el SDK para consumidores?
Puedes usar la información del SDK de Driver y Fleet Engine para crear experiencias personalizadas para los consumidores, incluidas las siguientes funciones:
Personaliza la IU del mapa para que se adapte a tus necesidades de desarrollo de la marca.
Sigue la ubicación actual del vehículo a medida que avanza por la ruta, con su posición actualizada periódicamente.
Muestra la hora estimada de llegada (ETA) para las ubicaciones de partida y destino.
Muestra la distancia restante.
Muestra el tráfico en vivo en la ruta.
Cómo funciona el SDK para consumidores
En un nivel alto, el SDK para consumidores se basa en los siguientes mecanismos:
- Tener los roles de Fleet Engine adecuados para que una app autenticada pueda seguir el viaje asociado con el pedido de un consumidor
- Es una asociación entre el consumidor y el viaje que proporciona tu sistema de backend.
- Las clases de SDK
TripModelyJourneySharingSessionque modelan los datos de viajes y comparten sesiones de viaje en la app para consumidores
El SDK para consumidores también proporciona otras interfaces y clases para que puedas crear una experiencia de app enriquecida con detalles como el tráfico, los marcadores de mapas, la hora de llegada estimada y los datos de ruta.
En esta tabla, se muestra el flujo de un viaje que sigue una app para consumidores.
| 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 recibe el ID y la información del viaje, y el conductor acepta el viaje. |
| 3 | La app para consumidores solicita acceso para seguir el viaje | La app para consumidores obtiene el ID del viaje de tu backend y solicita comenzar a seguir el viaje. |
| 4 | El conductor inicia el viaje | Cuando el conductor usa la app para indicar que comenzó el viaje, la app notifica a tu servidor de backend a través del SDK de Driver. Por ejemplo, cuando el conductor está a punto de salir del restaurante o conducir hasta la ubicación de partida. |
| 5 | Fleet Engine comienza a enviar información de viajes | Fleet Engine comienza a hacer un seguimiento del viaje y a compartir su progreso con la app para consumidores. |
| 6 | La app para consumidores muestra la información del viaje | La app para consumidores le notifica al consumidor y comienza a mostrarle la información del viaje, actualizándolo a medida que avanza. |
| 7 | El viaje se cancela o se completa | Cuando el conductor cancela o completa el viaje, la app del conductor inhabilita el seguimiento de ubicación, y tu servidor de backend le indica a Fleet Engine que marque el viaje como cancelado o completado. |
| 8 | La app para consumidores deja de seguir el viaje | El viaje aparece como cancelado o completo. |
| 9 | El proceso se repite para el próximo viaje | Se crea un viaje nuevo y se repite el proceso. |
Cómo usar el SDK de Consumer
Selecciona tu plataforma para ver cómo comenzar a seguir viajes en tus apps para consumidores.
Android
| 1 | Cómo configurar el SDK para consumidores en Android | Para seguir los viajes a pedido en tu app, configura el SDK para consumidores. Para obtener más información, consulta Cómo obtener el SDK de consumidor de Android. |
| 2 | Configura la interfaz visual | Define un mapa y agrega compatibilidad con mapas de vectores para configurar la experiencia del consumidor. Para obtener más información, consulta Cómo configurar un mapa. |
| 3 | Cómo seguir un viaje | Sigue un viaje para compartir la ubicación del vehículo adecuado con tu consumidor. 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 de tus viajes, como la distancia de viaje y la hora de llegada estimada, y controla los errores durante un viaje. Para obtener más información, consulta Cómo actualizar el progreso del viaje y Cómo controlar los errores de viaje. |
| 5 | Cómo dejar de seguir un viaje | 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 | Configura el SDK para consumidores en iOS | Para seguir los viajes a pedido en tu app, configura el SDK para consumidores. Para obtener más información, consulta Obtén el SDK para consumidores de iOS. |
| 2 | Configura la interfaz visual | Inicializa la vista del mapa y controla los eventos del mapa para configurar la experiencia del consumidor. Para obtener más información, consulta Cómo configurar un mapa. |
| 3 | Cómo seguir un viaje | Sigue un viaje para compartir la ubicación del vehículo adecuado con tu consumidor. 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 de tus viajes, como la distancia de viaje y la hora de llegada estimada, y controla los errores durante un viaje. Para obtener más información, consulta Cómo actualizar el progreso del viaje y Cómo controlar los errores de viaje. |
| 5 | Cómo dejar de seguir un viaje | 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 el SDK de consumidor en JavaScript | Para seguir los viajes a pedido en tu app, configura el SDK para consumidores. Para obtener más información, consulta Configura el SDK de consumidor de JavaScript. |
| 2 | Cómo cargar y personalizar un mapa | Habilita la API de Maps JavaScript y configura la autorización para configurar tu experiencia del consumidor. Para obtener más información, consulta Cómo configurar un mapa. |
| 3 | Cómo seguir un viaje | Sigue un viaje para compartir la ubicación del vehículo adecuado con tu consumidor. 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 de tus viajes, como la distancia recorrida y la hora de llegada estimada, y controla los errores que puedan ocurrir. Para obtener más información, consulta Cómo actualizar y seguir el progreso de un viaje y Cómo controlar los errores de viaje. |
| 5 | Cómo dejar de seguir un viaje | 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. |
Componentes
En esta sección, se resumen dos componentes necesarios para seguir un viaje:
De manera opcional, también puedes personalizar la experiencia del consumidor con estos componentes:
Obtenedor de tokens de autenticación
Para controlar el acceso a los datos de ubicación almacenados en Fleet Engine, debes hacer lo siguiente:
Implementa un servicio de creación de tokens web JSON (JWT) para Fleet Engine en tu servidor. Para obtener más información, consulta Cómo emitir JWT.
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. Si quieres obtener más información para configurar un recuperador de tokens, consulta la guía de configuración para Android, iOS o JavaScript.
Vista de mapa y dispositivos de rastreo de viajes
El seguimiento de un viaje 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 (ETA) de un conductor o la distancia restante que debe recorrer.
En la siguiente tabla, se describen estos componentes:
| Componente | Descripción |
|---|---|
| Vista de mapa para consumidores | La vista de mapa administra el ciclo de vida de un viaje y muestra los puntos de referencia para la ubicación de los vehículos a medida que avanza el viaje. Si se conoce la ruta de un vehículo, la vista del mapa actualiza el polilinea de la ruta del vehículo para indicar el progreso del vehículo a lo largo de su ruta. |
| Proveedor de ubicación de viaje en JavaScript | En el caso de las apps web de JavaScript, el proveedor de ubicación del viaje envía información de ubicación para los objetos a los que se les hace un seguimiento al mapa de viaje compartido. Para obtener más información, consulta Cómo crear una instancia de un proveedor de ubicación de viaje.
Puedes usar el proveedor de ubicación de viajes para hacer un seguimiento de los siguientes detalles de un viaje:
|
Objetos de ubicación que se rastrean
El proveedor de ubicación realiza un seguimiento de la ubicación de objetos, como puntos de referencia y vehículos, que se describen en la siguiente tabla.
| Ubicación con seguimiento | Descripción |
|---|---|
| Lugar de recogida | La ubicación de partida es la ubicación donde comienza un viaje. |
| Ubicación de destino | La ubicación de destino es la ubicación donde finaliza 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 viaje con seguimiento. Si bien, técnicamente, los puntos de referencia pueden incluir ubicaciones de partida y destino, por lo general, se refieren a paradas intermedias a lo largo de la ruta. Por ejemplo, las paradas entre las ubicaciones de partida y destino en una ruta de entrega son ubicaciones de punto 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 informada de un vehículo. Para obtener más información, consulta Ubicación del vehículo en la documentación de Fleet Engine. |
Aplica diseño a tus mapas
Los estilos de marcadores y polilíneas determinan el aspecto de los objetos de ubicación con seguimiento en el mapa. Puedes usar opciones de diseño personalizado para que coincidan con el estilo de tu aplicación web.
Controla la visibilidad de las ubicaciones que se rastrean
Los proveedores de ubicaciones predefinidos en Fleet Engine siguen estas reglas de visibilidad para los objetos de ubicación con seguimiento en el mapa. Si creas un proveedor de ubicación personalizado o derivado, puedes cambiar las reglas de visibilidad.
Los vehículos solo se pueden ver cuando el viaje está en curso: Los vehículos de un viaje se pueden ver desde el momento en que se asignan a un viaje hasta el momento de la bajada. Si se cancela el viaje, el vehículo ya no se puede ver.
Todos los demás marcadores de ubicación siempre son visibles: Todos los demás marcadores de ubicación para el origen, el destino y los puntos de referencia siempre se muestran en el mapa. Por ejemplo, la ubicación de entrega de un viaje o de un envío siempre se muestra en el mapa, independientemente del estado del viaje o la entrega.
¿Qué sigue?
Consulta la documentación de la plataforma en la que deseas seguir los viajes: