Fleet Engine udostępnia punkt końcowy SearchTripsRequest, którego możesz używać do wyszukiwania przejazdów. W tym dokumencie opisujemy 2 scenariusze, w których możesz użyć tej funkcji.
Zobacz SearchTripsRequest w przypadku gRPC lub trips.Search w przypadku REST.
Określanie aktywnych przejazdów pojazdu
Aby znaleźć aktywne przejazdy dla określonych pól, użyj komunikatu SearchTripsRequest, aby ustawić vehicle_id na dany pojazd i ustawić active_trips_only na true.
Uzgodnij dostępność pojazdów między systemem a Fleet Engine
W niektórych sytuacjach możesz zobaczyć wyniki zwrócone 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 obniża ich pozycję 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 lub CANCELED. Używając SearchTrips do znajdowania otwartych przejazdów, możesz oceniać pojazdy, aby upewnić się, że TripStatus w Twoim systemie odpowiada temu w Fleet Engine.
Aby używać SearchTrips w ten sposób, ustaw te wartości w komunikacie SearchTripsRequest:
- Pole
vehicle_idpowinno być puste. - Pole
active_trips_onlypowinno mieć wartośćtrue. minimum_stalenesspowinna być dłuższa niż większość przejazdów, np. 1 godzina.
Wyniki takiego żądania obejmują przejazdy, które nie są ani 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 jest prawidłowo aktualizowany.