En la documentación de esta sección, se muestra cómo crear y trabajar con viajes usando el servicio de viajes a pedido de Google Maps Mobility. Se supone que conoces los siguientes temas:
- Fleet Engine: Debes conocer los detalles de implementación, los mecanismos de solicitud y la seguridad de Fleet Engine. Para ello, consulta ¿Qué es el servicio de Fleet Engine? y los temas de seguridad en Configura Fleet Engine.
- Conceptos básicos de los vehículos para los servicios a pedido Consulta Introducción a los vehículos.
- Conceptos básicos del viaje para los servicios a pedido Consulta Viajes a pedido.
El TripService que usarás está disponible para gRPC y REST.
Para simplificar, las referencias de campo siguen la convención de gRPC.
En Fleet Engine para servicios a pedido, un viaje es un tipo de recorrido que modela el cumplimiento de una solicitud de viaje o entrega de comida de tus consumidores. Un viaje tiene un estado que informas a Fleet Engine a medida que avanza el recorrido, como NEW, ENROUTE_TO_PICKUP y muchos más. El estado del viaje corresponde a las paradas ubicadas geográficamente que se asignan al vehículo, y Fleet Engine modifica estas paradas del vehículo con cada actualización de viaje que realices. Consulta Viajes a pedido en Conceptos básicos de Fleet Engine para obtener más información sobre los viajes y su relación con los vehículos.
Ciclo de vida de un viaje
Para hacer un seguimiento de cada viaje en Fleet Engine, primero debes crear una entidad Trip. Consulta gRPC o REST como referencia.
En la siguiente tabla, se describe un ejemplo de flujo de extremo a extremo de un viaje creado en tu sistema y sus etapas del ciclo de vida en Fleet Engine. Se supone que configuraste Fleet Engine y tienes un vehículo para asignarle al viaje, con las actualizaciones de ubicación habilitadas en la app para el conductor. Consulta SDK de Driver: viajes a pedido.
| 1 | Recibe la solicitud de reserva. | Antes de que comience un viaje de Fleet Engine, tu sistema de reservas primero recibe una solicitud de viaje o entrega de un consumidor a través de tu app o de otro sistema de reservas. Luego, tu sistema crea la entidad del viaje con CreateTrip y los campos obligatorios, como la ubicación de partida.
También puede establecer otros campos en este punto, como pasajeros y ubicación de destino, o esperar hasta que asigne un vehículo. Consulta Cómo crear un viaje de un solo destino. |
| 2 | Asigna el vehículo. | Puedes asignar vehículos a viajes directamente en tu sistema y, luego, informar la asignación a Fleet Engine, o bien puedes usar el servicio Search Vehicle para buscar vehículos y filtrar por atributos de viaje y de vehículo para encontrar el mejor vehículo para completar el viaje. Cualquier vehículo en línea dentro de tu radio de búsqueda da a conocer su proximidad a través de las actualizaciones de ubicación que proporciona el SDK del Driver. Una vez que |
| 3 | Actualiza el viaje. | Una vez que el conductor acepta el viaje y comienza a navegar hacia la ubicación de partida, tu sistema actualiza el estado del viaje de NEW a ENROUTE_TO_PICKUP. Sigues sondeo la ubicación del vehículo durante todo el viaje, ya sea a través de una conexión directa de la app a tu backend o sondeando Fleet Engine, que recibe un flujo continuo de actualizaciones de la ubicación del vehículo desde el SDK de Driver. Luego, tu sistema informa cada hito del viaje a Fleet Engine, que actualiza la lista de puntos de referencia del vehículo según corresponda.
|
| 4 | Comparte el viaje con el consumidor. | Fleet Engine pone a disposición del SDK del consumidor los detalles del viaje y la ubicación del vehículo, que usa un objeto de escucha para recibir actualizaciones del viaje y mostrarlas en la app del consumidor. Fleet Engine actualiza automáticamente la ETA, la distancia restante, las rutas y los puntos de referencia restantes del vehículo. Consulta Cómo compartir viajes para viajes a pedido para obtener más información. |
| 5 | Viaje completo. | Una vez que el vehículo llega al punto de ruta de destino del viaje y el conductor indica que el viaje se completó correctamente, tu sistema establece TripStatus en COMPLETE en Fleet Engine. Ten en cuenta que, al igual que los vehículos, las entidades de viajes permanecen activas en Fleet Engine durante 7 días, independientemente de su estado, y luego se quitan. |
Flujo de secuencia del viaje
En el siguiente diagrama, se muestra una vista más detallada de este flujo.
