Trova viaggi

Fleet Engine fornisce l'endpoint SearchTripsRequest che puoi utilizzare per trovare i 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 questione e active_trips_only su true.

Riconciliare la disponibilità dei veicoli tra il 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 nel tuo parco risorse. Questo 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 i viaggi, ma lo stato del viaggio non è stato impostato correttamente su COMPLETE o CANCELED. Utilizzando SearchTrips per trovare i 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 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.

Passaggi successivi