Trova viaggi

Fleet Engine fornisce l'endpoint SearchTripsRequest che puoi utilizzare per trovare viaggi. 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.

Riconcilia la disponibilità dei veicoli tra il tuo sistema e Fleet Engine

In alcune situazioni, potresti visualizzare risultati restituiti da SearchVehicles che non corrispondono ai veicoli che sai essere disponibili nel tuo sistema e nella tua flotta. Ciò accade perché SearchVehicles non mostra i veicoli con viaggi attivi o li sposta in basso nella classifica dei risultati. Una delle cause è che i veicoli hanno completato le corse, ma lo stato della corsa non è stato impostato correttamente su COMPLETE o CANCELED. Utilizzando SearchTrips per trovare viaggi aperti, puoi valutare i veicoli per assicurarti che TripStatus nel tuo sistema corrisponda a quello di Fleet Engine.

Per utilizzare SearchTrips in questo modo, imposta quanto segue nel messaggio SearchTripsRequest:

  • vehicle_id deve essere vuoto.
  • active_trips_only deve essere true.
  • minimum_staleness deve essere un tempo superiore alla maggior parte delle durate dei viaggi, ad esempio un'ora.

I risultati di una richiesta di questo tipo includono 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.

Passaggi successivi