Questo documento descrive come creare un viaggio consecutivo, impostare i campi corretti e assegnarlo a un veicolo da soddisfare. Si presume che tu abbia configurato il parco risorse Engine, hai creato veicoli, disponi di un'app per conducente funzionante e un'app consumer, facoltativamente. Dovresti anche conoscere i vari percorsi disponibili per le corse on demand. Consulta le seguenti guide correlate per che:
- Configurare Fleet Engine
- Creare un veicolo
- Scenari di viaggio nella panoramica Viaggi on demand
Nozioni di base sulla creazione di viaggi
Questa sezione descrive i dettagli della richiesta necessari per creare un viaggio in Fleet Engine. Puoi inviare una richiesta di creazione utilizzando gRPC e REST.
Campi viaggio
Utilizza i campi seguenti per creare una corsa in Fleet Engine. Puoi utilizzare diversi campi per i diversi tipi di corse: con una o più destinazioni, consecutive o con pooling condiviso. Puoi fornire i campi facoltativi quando crei il viaggio oppure impostarli in un secondo momento quando aggiorni il viaggio.
Nome | Obbligatorio? | Descrizione |
---|---|---|
parent | Sì | Una stringa che include l'ID progetto. Questo ID deve essere lo stesso utilizzato nell'intera integrazione di Fleet Engine, con lo stesso account di servizio ruoli. |
trip_id | Sì | Una stringa creata da te che identifica in modo univoco questo viaggio. Gli ID viaggio sono alcune limitazioni, come indicato nel riferimento. |
trip_type | Sì | Imposta TripType sui seguenti valori per il tipo di viaggio che stai creando:
|
pickup_point | Sì | Il punto di partenza della corsa. |
Destinazioni intermedie | Sì | Solo viaggi con più destinazioni: l'elenco delle destinazioni intermedie visitate dal conducente.
ritiro e consegna. Come per |
vehicle_waypoints | Sì | Solo viaggi con car pooling: questo campo supporta l'interlacciamento dei waypoint di più viaggi.
Contiene tutte le tappe rimanenti per il veicolo assegnato, nonché
come tappe di partenza e arrivo della corsa. Puoi impostare questo campo chiamando |
number_of_passengers | No | Il numero di passeggeri del viaggio. |
dropoff_point | No | La destinazione del viaggio. |
vehicle_id | No | L'ID del veicolo assegnato alla corsa. |
Esempio: creare un viaggio consecutivo
Di seguito viene mostrato come creare un viaggio consecutivo e assegnarlo a un veicolo. In questo scenario, la creazione di un viaggio è la stessa di un viaggio con una sola destinazione. Solo in un secondo momento puoi creare un'altra corsa e assegnarla a un veicolo con una corsa già attiva.
// A vehicle with ID 'my-vehicle' is already created and it is assigned to a trip with ID 'current-trip'.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String VEHICLE_ID =" my-vehicle";
static final String TRIP_ID = "back-to-back-trip");
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
Trip trip = Trip.newBuilder()
.setTripType(TripType.EXCLUSIVE)
.setPickupPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)))
.setDropoffPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.1275).setLongitude(106.6537)))
.setVehicleId(VEHICLE_ID)
.build();
// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId(TRIP_ID)
.setTrip(trip)
.build();
// Error handling.
try {
// Fleet Engine automatically assigns a 'waypoints' list to the trip containing
// the vehicle's current trip waypoints.
Trip createdTrip =
tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
Aggiornare i viaggi consecutivi
Quando assegni un veicolo per un viaggio consecutivo, assegni un viaggio a un veicolo anche se ne è già stato assegnato uno.
Qualsiasi corsa creata in Fleet Engine deve essere assegnata a un veicolo per Fleet Engine per calcolare l'orario di arrivo stimato delle corse e monitorarlo. Puoi farlo durante la creazione della corsa o in un secondo momento quando aggiorni la corsa.
Dopo aver assegnato la corsa a un veicolo, Fleet Engine aggiunge automaticamente i waypoint associati alle corse consecutive al campo waypoint del veicolo. Il campo remainingWaypoints
di un viaggio contiene un elenco di tutti i waypoint, inclusi quelli di altri viaggi che verranno visitati prima del drop-off del viaggio.
Ad esempio, prendiamo in considerazione due viaggi consecutivi: Viaggio A e Viaggio B. Il veicolo ha ritirato il consumatore per la Trip A e lungo il percorso verso la fermata località, il conducente riceve una richiesta di ritiro di un altro consumatore per prossimo viaggio, Trip B.
- La chiamata a
getVehicle()
restituisceremainingWaypoints
che contiene:
A Ricarica → B Ricarica → B Ricarica. getTrip()
o il callbackonTripRemainingWaypointsUpdated
per Viaggio A restituisceremainingWaypoints
contenenti:
Una consegna.getTrip()
o il callbackonTripRemainingWaypointsUpdated
per Viaggio B restituisceremainingWaypoints
contenente:
A Ritrovamento → B Ritiro → e B Ritrovamento.