¿Qué es un viaje a pedido?

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:

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 SearchVehicle devuelva un vehículo que coincida con un viaje, tu El sistema llama al extremo UpdateTrip para informar el ID del vehículo. que asignaste para el viaje NEW.

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.

TripSequenceDiagram

¿Qué sigue?