Fleet Engine fornisce l'endpoint SearchTripsRequest
che puoi utilizzare per trovare
per i viaggi. Questo documento descrive due scenari in cui potresti utilizzare questa funzionalità.
Vedi SearchTripsRequest
per gRPC o trips.Search
per REST.
Determinare le corse attive per un veicolo
Per trovare le corse attive per un campo specifico, utilizza SearchTripsRequest
messaggio per impostare vehicle_id
sul veicolo in esame e impostare
active_trips_only
a true
.
Riconcilia la disponibilità di veicoli tra il tuo sistema e Fleet Engine
In alcune situazioni, potresti vedere risultati restituiti da SearchVehicles
che
non corrispondono ai veicoli che sai di essere disponibili nel tuo sistema e
della tua flotta. Questo accade perché su SearchVehicles
non vengono mostrati i veicoli
con corse attive o li spinge verso il basso nella classifica dei risultati. Una delle cause
si verifica quando i veicoli hanno completato le corse, ma lo stato della corsa non è stato impostato correttamente.
in COMPLETE
o CANCELED
. Utilizzando SearchTrips
per trovare le corse aperte,
puoi valutare i veicoli per assicurarti che TripStatus
nel tuo sistema corrisponda
quella di Fleet Engine.
Per utilizzare SearchTrips
in questo modo, imposta quanto segue nel campo SearchTripsRequest
messaggio:
- Il campo
vehicle_id
deve essere vuoto. active_trips_only
deve esseretrue
.minimum_staleness
deve essere un tempo maggiore di quello della maggior parte delle durate dei viaggi. della esempio, un'ora.
I risultati di una richiesta di questo tipo includono Viaggi che non sono né COMPLETE
CANCELED
e non vengono aggiornate da più di un'ora. Puoi quindi esaminare
per verificare che il loro stato in Fleet Engine venga aggiornato correttamente.