Trova viaggi

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.

Determina le corse attive per un veicolo

Per trovare le corse attive per campi specifici, utilizza il messaggio SearchTripsRequest per impostare vehicle_id sul veicolo in questione e 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. 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 è quando i veicoli hanno completato le corse, ma lo stato della corsa non è stato impostato correttamente su COMPLETE o CANCELED. Utilizzando SearchTrips per trovare le corse aperte, 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 dovrebbe essere true.
  • minimum_staleness deve essere un orario superiore alla maggior parte delle durate delle corse, ad esempio un'ora.

I risultati di una richiesta di questo tipo includono le corse che non sono né COMPLETE né CANCELED e che non sono state aggiornate da più di un'ora. Puoi quindi esaminare queste corse per assicurarti che il loro stato in Fleet Engine sia aggiornato correttamente.

Passaggi successivi