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
. Używając SearchTrips
do wyszukiwania otwartych przejazdów, możesz oceniać pojazdy, aby mieć pewność, że TripStatus
w Twoim systemie odpowiada temu w Fleet Engine.
Aby użyć SearchTrips
w ten sposób, ustaw w SearchTripsRequest
wiadomości te wartości:
- Pole
vehicle_id
powinno być puste. - Wartość
active_trips_only
powinna wynosićtrue
. minimum_staleness
powinien być czasem dłuższym niż większość podróży, np. godziną.
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.