En la documentación de esta sección, se muestra cómo crear viajes y trabajar con ellos mediante el servicio de viajes a pedido de Google Maps Mobility. Se supone que estás familiarizado con lo siguiente:
- Fleet Engine: Debes estar familiarizado con 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 vehículos para servicios a pedido. Consulta Introducción a los vehículos.
- Conceptos básicos de viajes para 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 entrega de comida o de viaje de tus consumidores. Un viaje tiene un estado que informas a Fleet Engine a medida que evoluciona el recorrido, como NEW, ENROUTE_TO_PICKUP y otros. El estado del viaje corresponde a los puntos de referencia geolocalizados asignados al vehículo, y Fleet Engine modifica estos puntos de referencia del vehículo con cada actualización de viaje que realices. Consulta Viajes a pedido en Aspectos 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 asignar al viaje, con las actualizaciones de ubicación habilitadas en la app para conductores. Consulta SDK para conductores: 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 de viaje con
CreateTrip con 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
Crea un viaje de un solo destino. |
| 2 | Asigna el vehículo. | Puedes asignar vehículos a viajes directamente en tu sistema y notificar la asignación a Fleet Engine, o bien puedes usar el servicio de búsqueda de vehículos para buscar vehículos, filtrando por atributos de viaje y de vehículo para encontrar el mejor vehículo para completar el recorrido. Cualquier vehículo en línea dentro de tu radio de búsqueda hace que su proximidad se conozca a través de las actualizaciones de ubicación que proporciona el SDK para conductores. 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. Continúas sondeando la ubicación del vehículo
durante todo el recorrido, ya sea a través de una conexión directa de
la app a tu backend o sondeando Fleet Engine, que recibe una
transmisión continua de actualizaciones de ubicación del vehículo del SDK para conductores. Luego, tu
sistema informa cada hito del recorrido a Fleet Engine, que actualiza
la lista de puntos de referencia del vehículo en consecuencia.
|
| 4 | Comparte el recorrido con el consumidor. | Fleet Engine pone a disposición del SDK para consumidores 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 para consumidores. Fleet Engine actualiza automáticamente la hora de llegada estimada, la distancia restante, las rutas y los puntos de referencia restantes del vehículo. Consulta Comparte viajes para viajes a pedido para obtener más información. |
| 5 | Completa el viaje. | Una vez que el vehículo llega al punto de referencia de destino del viaje y el
conductor indica que el viaje se realizó correctamente, tu sistema establece el
TripStatus en COMPLETE en Fleet Engine. Ten en
en cuenta que, al igual que los vehículos, las entidades de viaje permanecen activas en Fleet Engine
durante 7 días, independientemente del estado, momento en el que se quitan. |
Flujo de secuencia de viajes
En el siguiente diagrama, se muestra una vista más detallada de este flujo.
