Fleet Engine fornisce l'endpoint SearchTripsRequest
che puoi utilizzare per trovare
le corse. Questo documento descrive due scenari in cui potresti utilizzare questa funzionalità.
Consulta SearchTripsRequest
per gRPC o trips.Search
per REST.
Determinare i viaggi attivi per un veicolo
Per trovare i viaggi attivi per campi specifici, utilizza il messaggio SearchTripsRequest
per impostare vehicle_id
sul veicolo in esame e imposta
active_trips_only
su true
.
Riconciliare la disponibilità dei veicoli tra il tuo sistema e Fleet Engine
In alcuni casi, potresti visualizzare risultati restituiti da SearchVehicles
che
non corrispondono ai veicoli che sai essere disponibili nel tuo sistema e
nel tuo parco veicoli. Questo accade perché SearchVehicles
non mostra i veicoli con corse attive o li spinge verso il basso nel ranking dei risultati. Una causa di questo problema è rappresentata dalla situazione in cui i veicoli hanno completato le corse, ma lo stato della corsa non è stato impostato correttamente su COMPLETE
o CANCELED
. Utilizzando SearchTrips
per trovare corse aperte,
puoi valutare i veicoli per assicurarti che SearchTrips
nel tuo sistema corrisponda
a quello di Fleet Engine.TripStatus
Per utilizzare SearchTrips
in questo modo, imposta quanto segue nel messaggio SearchTripsRequest
:
vehicle_id
deve essere vuoto.active_trips_only
deve esseretrue
.minimum_staleness
deve essere un periodo di tempo maggiore della maggior parte delle durate dei viaggi, ad esempio un'ora.
I risultati di una richiesta di questo tipo includono i viaggi che non sono né COMPLETE
né
CANCELED
e che non sono stati aggiornati da più di un'ora. Puoi quindi esaminare questi viaggi per assicurarti che il loro stato in Fleet Engine sia aggiornato correttamente.