O Fleet Engine fornece o endpoint SearchTripsRequest, que pode ser usado para encontrar viagens. Este documento descreve dois cenários em que você pode usar esse recurso.
Consulte SearchTripsRequest para gRPC ou trips.Search para REST.
Determinar viagens ativas para um veículo
Para encontrar as viagens ativas de um campo específico, use a mensagem SearchTripsRequest para definir vehicle_id como o veículo em questão e active_trips_only como true.
Conciliar a disponibilidade de veículos entre seu sistema e o Fleet Engine
Em algumas situações, você pode encontrar resultados retornados por SearchVehicles que não correspondem aos veículos disponíveis no seu sistema e na sua frota. Isso acontece porque o SearchVehicles não mostra veículos com viagens ativas ou os coloca em uma posição mais baixa no ranking de resultados. Uma das causas é quando os veículos concluíram as viagens, mas o status não foi definido corretamente como COMPLETE ou CANCELED. Ao usar SearchTrips para encontrar viagens em aberto, é possível avaliar os veículos para garantir que TripStatus no seu sistema corresponda ao do Fleet Engine.
Para usar SearchTrips dessa forma, defina o seguinte na mensagem SearchTripsRequest:
vehicle_idprecisa estar vazio.active_trips_onlyprecisa sertrue.minimum_stalenessprecisa ser um tempo maior que a maioria das durações de viagem, por exemplo, uma hora.
Os resultados de uma solicitação desse tipo incluem viagens que não são COMPLETE nem CANCELED e não foram atualizadas em mais de uma hora. Em seguida, examine essas viagens para garantir que o status delas no Fleet Engine seja atualizado corretamente.