Znajdź podróże

Fleet Engine udostępnia punkt końcowy SearchTripsRequest, za pomocą którego można znajdować przejazdy. W tym dokumencie opisaliśmy 2 sytuacje, w których możesz użyć tej funkcji.

W przypadku gRPC użyj wartości SearchTripsRequest, a w przypadku REST – trips.Search.

Określanie aktywnych przejazdów pojazdu

Aby znaleźć aktywne przejazdy w przypadku określonych pól, użyj wiadomości SearchTripsRequest, aby ustawić wartość pola vehicle_id na pojazd, który chcesz rozważyć, a wartość pola active_trips_only na true.

Porównywanie dostępności pojazdów między systemem a Fleet Engine

W niektórych sytuacjach SearchVehicles może zwrócić wyniki, które nie odpowiadają pojazdom dostępnym w Twoim systemie i flotach. Dzieje się tak, ponieważ SearchVehicles nie wyświetla pojazdów z aktywnymi przejazdami lub przesuwa je w rankingu wyników. Jedną z przyczyn takiej sytuacji jest to, że pojazdy ukończyły przejazdy, ale stan przejazdu nie został prawidłowo ustawiony na COMPLETE lub CANCELED. Korzystając z funkcji SearchTrips, aby znaleźć otwarte przejazdy, możesz ocenić pojazdy, aby mieć pewność, że TripStatus w Twoim systemie jest zgodny z Fleet Engine.

Aby użyć funkcji SearchTrips w ten sposób, w wiadomości SearchTripsRequest ustaw:

  • Pole vehicle_id powinno być puste.
  • Wartość active_trips_only powinna wynosić true.
  • Wartość minimum_staleness powinna być większa niż większość czasów trwania przejazdu, na przykład 1 godzina.

Wyniki takiego żądania obejmują Podróże, które nie są oznaczone jako COMPLETE ani CANCELED i nie były aktualizowane od ponad godziny. Następnie możesz sprawdzić te przejazdy, aby mieć pewność, że ich stan w Fleet Engine jest prawidłowo zaktualizowany.

Co dalej?