Fleet Engine udostępnia punkt końcowy SearchTripsRequest, którego możesz użyć do wyszukiwania przejazdów. W tym dokumencie opisujemy 2 scenariusze, w których możesz użyć tej funkcji.
Więcej informacji znajdziesz w dokumentacji SearchTripsRequest dla gRPC lub trips.Search dla REST.
Określanie aktywnych przejazdów dla pojazdu
Aby znaleźć aktywne przejazdy dla określonych pól, użyj wiadomości SearchTripsRequest, aby ustawić vehicle_id na rozpatrywany pojazd i ustawić active_trips_only na true.
Uzgodnienie dostępności pojazdów między Twoim systemem a Fleet Engine
W niektórych sytuacjach możesz zobaczyć wyniki zwracane przez SearchVehicles, które nie odpowiadają pojazdom, o których wiesz, że są dostępne w Twoim systemie i flocie. Dzieje się tak, ponieważ SearchVehicles nie wyświetla pojazdów z aktywnymi przejazdami lub umieszcza je niżej w rankingu wyników. Jedną z przyczyn jest to, że pojazdy zakończyły przejazdy, ale stan przejazdu nie został prawidłowo ustawiony na COMPLETE ani CANCELED. Używając SearchTrips do znajdowania otwartych przejazdów, możesz ocenić pojazdy, aby mieć pewność, że TripStatus w Twoim systemie jest zgodny z tym w Fleet Engine.
Aby użyć SearchTrips w ten sposób, ustaw w SearchTripsRequest
wiadomości te wartości:
vehicle_idpowinno być puste.active_trips_onlypowinno mieć wartośćtrue.minimum_stalenesspowinno być czasem dłuższym niż większość czasów trwania przejazdów, np. godzinę.
Wyniki takiego żądania obejmują przejazdy, które nie są ani COMPLETE, ani CANCELED i nie były aktualizowane od ponad godziny. Możesz wtedy sprawdzić te przejazdy, aby mieć pewność, że ich stan w Fleet Engine jest prawidłowo aktualizowany.