Fleet Engine udostępnia punkt końcowy SearchTripsRequest
, którego możesz używać do znajdowania przejazdów. W tym dokumencie opisujemy 2 sytuacje, w których możesz użyć tej funkcji.
W przypadku gRPC użyj polecenia SearchTripsRequest
, a w przypadku REST – trips.Search
.
Określanie aktywnych przejazdów pojazdu
Aby znaleźć aktywne przejazdy w określonych polach, użyj wiadomości SearchTripsRequest
, aby ustawić wartość pola vehicle_id
na pojazd, który Cię interesuje, a wartość pola active_trips_only
na true
.
Porównanie dostępności pojazdu między Twoim systemem a Fleet Engine
W niektórych sytuacjach SearchVehicles
może zwracać 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 może być sytuacja, w której pojazdy ukończyły przejazdy, ale stan przejazdu nie został prawidłowo ustawiony na COMPLETE
lub CANCELED
. Korzystając z funkcji SearchTrips
, możesz znaleźć otwarte przejazdy, aby ocenić pojazdy i upewnić się, że TripStatus
w Twoim systemie jest zgodny z Fleet Engine.
Aby użyć SearchTrips
w ten sposób, w wiadomości SearchTripsRequest
ustaw:
- Wartość
vehicle_id
powinna być pusta. - Wartość
active_trips_only
powinna wynosićtrue
. - Wartość
minimum_staleness
powinna być większa niż czas trwania większości przejazdów, 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 upewnić się, że ich stan w Fleet Engine został prawidłowo zaktualizowany.