Fleet Engine udostępnia punkt końcowy SearchTripsRequest, którego możesz używać do wyszukiwania przejazdów. W tym dokumencie opisujemy 2 sytuacje, w których możesz użyć tej funkcji.
Więcej informacji o gRPC znajdziesz w SearchTripsRequest, a o REST – w trips.Search.
Określanie aktywnych przejazdów 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.
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 dostępnym 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 tego problemu jest sytuacja, w której pojazdy zakończyły przejazdy, ale stan przejazdu nie został prawidłowo ustawiony na COMPLETE lub CANCELED. Korzystając z SearchTrips do wyszukiwania otwartych przejazdów, możesz oceniać pojazdy, aby mieć pewność, że TripStatus w Twoim systemie odpowiadaTripStatus w Fleet Engine.
Aby użyć SearchTrips w ten sposób, w SearchTripsRequest
wiadomości ustaw:
- Pole
vehicle_idpowinno być puste. - Wartość
active_trips_onlypowinna wynosićtrue. minimum_stalenesspowinien być czasem dłuższym niż większość czasów trwania przejazdów, np. godzinę.
Wyniki takiego żądania obejmują podróże, które nie są ani COMPLETE, ani CANCELED i nie były aktualizowane od ponad godziny. Następnie możesz sprawdzić te podróże i upewnić się, że ich status w Fleet Engine jest prawidłowo aktualizowany.