Encontrar viagens

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 de um veículo

Para encontrar as viagens ativas de um campo específico, use a mensagem SearchTripsRequest para definir o vehicle_id como o veículo em questão e definir active_trips_only como true.

Conciliar a disponibilidade do veículo entre seu sistema e o Fleet Engine

Em algumas situações, os resultados retornados por SearchVehicles podem não corresponder aos veículos que você sabe que estão disponíveis no sistema e na frota. Isso acontece porque SearchVehicles não mostra veículos com viagens ativas ou os empurra para baixo na classificação de resultados. Uma das causas disso é quando os veículos concluíram viagens, mas o status da viagem não foi definido corretamente como COMPLETE ou CANCELED. Ao usar SearchTrips para encontrar viagens abertas, é possível avaliar os veículos para garantir que o TripStatus no seu sistema corresponda ao do Fleet Engine.

Para usar SearchTrips dessa maneira, defina o seguinte na mensagem SearchTripsRequest:

  • vehicle_id precisa estar vazio.
  • active_trips_only precisa ser true.
  • O minimum_staleness precisa ser um tempo maior que a maioria das durações de viagem, por exemplo, uma hora.

Os resultados dessa solicitação incluem viagens que não são COMPLETE nem CANCELED e que não foram atualizadas há mais de uma hora. Em seguida, examine essas viagens para garantir que o status delas no Fleet Engine seja atualizado corretamente.

A seguir