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 movilidad de Google Maps. Además, supone que el usuario tiene conocimientos previos lo siguiente:
- Fleet Engine: Debes estar familiarizado con la implementación de Fleet Engine. detalles, mecanismos de solicitud y seguridad. Para ello, consulta ¿Qué es la flota? Engine? y los temas de seguridad en Configura Fleet Engine.
- Conceptos básicos sobre vehículos para los servicios a pedido Consulta Introducción a los vehículos.
- Conceptos básicos del viaje para servicios a pedido Consulta Viajes on demand.
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
la entrega de una entrega de comida o una solicitud 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 valores de ubicación
los puntos de referencia asignados al vehículo y Fleet Engine modifica estos vehículos
puntos de referencia con cada actualización de viaje que realices. Consulta los viajes a pedido en Flota.
Conceptos básicos de los motores para obtener más información sobre los viajes y su relación con los vehículos
Duración de un viaje
Para realizar un seguimiento de cada viaje en Fleet Engine, primero debes crear un Trip
. Consulta gRPC o REST como referencia.
La siguiente tabla describe un ejemplo de flujo completo de un viaje creado en del sistema y las etapas de su ciclo de vida en Fleet Engine. Se supone que configuraste Fleet Engine y tienen un vehículo para asignar al viaje, con actualizaciones de ubicación habilitado en la app del controlador. Consulta SDK del conductor: viajes a pedido.
1 | Recibir una solicitud de reserva | Antes de que comience un viaje de Fleet Engine, tu sistema de reservas primero recibe una
solicitar un viaje o una entrega a un consumidor a través de su aplicación o de otro
sistema de reservas. Luego, tu sistema crea la entidad de viaje usando
CreateTrip con campos obligatorios, como el lugar de retiro.
También puede establecer otros campos en este punto, como pasajeros y
ubicación de destino o espera hasta que se asigne un vehículo. Consulta
Crea un viaje con un solo destino. |
2 | Asignar vehículo. | Puedes asignar vehículos a los viajes directamente en tu sistema e informar la asignación a Fleet Engine, o puedes usar Buscar vehículo para buscar vehículos y filtrar por viaje y vehículo para encontrar el mejor vehículo para completar el viaje. Cualquier actividad en línea vehículo dentro de un radio de búsqueda hace que se conozca su proximidad mediante de ubicación que proporciona el SDK de Driver. Una vez que |
3 | Actualiza el viaje. | Una vez que el conductor acepta el viaje y comienza a navegar hacia
lugar de recogida, tu sistema actualizará el estado del viaje de NEW
a ENROUTE_TO_PICKUP . Sigues sondeando el vehículo
ubicación a lo largo del viaje, ya sea a través de una conexión directa desde
la app a tu backend o sondeando Fleet Engine, que recibe un
flujo continuo de actualizaciones de ubicación de vehículos desde el SDK de Driver. Tu
y, luego, informa cada hito del recorrido a Fleet Engine, que actualiza
la lista de puntos de referencia del vehículo según corresponda.
|
4 | Comparte el recorrido con el consumidor. | Fleet Engine pone a disposición los detalles del viaje y la ubicación del vehículo para el SDK de consumidor, que usa un objeto de escucha para recibir actualizaciones de viaje y mostrarlas en la aplicación para consumidores. Fleet Engine actualiza automáticamente la hora de llegada estimada, lo que resta distancia, rutas y puntos de referencia restantes para vehículos. Consulta Comparte recorridos para viajes según demanda para obtener más información. |
5 | Viaje completo. | Una vez que el vehículo llega al punto de referencia del viaje y tu
conductor indica un viaje exitoso, tu sistema establece la
De TripStatus a COMPLETE en Fleet Engine. Conservar en
al igual que los vehículos, las entidades de viaje permanecen activas en Fleet Engine
durante 7 días, sin importar el estado. A partir de ese momento, se quitarán. |
Flujo de la secuencia de viaje
En el siguiente diagrama, se muestra una vista más detallada de este flujo.