Encontrar viagens

O Fleet Engine fornece o endpoint SearchTripsRequest, que pode ser usado para encontrar viagens. Neste documento, descrevemos dois cenários em que esse recurso pode ser usado.

Consulte SearchTripsRequest para gRPC ou trips.Search para REST.

Determinar viagens ativas de um veículo

Para encontrar as viagens ativas em campos específicos, use o SearchTripsRequest para definir o vehicle_id como o veículo em questão e active_trips_only para true.

Reconcilie a disponibilidade de veículos entre seu sistema e o Fleet Engine

Em algumas situações, você poderá ver resultados retornados por SearchVehicles que não correspondem aos veículos que você sabe que estão disponíveis no sistema sua frota. Isso acontece porque o SearchVehicles não mostra veículos. com viagens ativas ou diminui-las na classificação dos resultados. Uma das causas disso ocorre quando os veículos completam 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 veículos para garantir que TripStatus no sistema corresponda a do Fleet Engine.

Para usar SearchTrips dessa forma, defina o seguinte no SearchTripsRequest mensagem:

  • vehicle_id deve estar em branco.
  • active_trips_only precisa ser true.
  • minimum_staleness precisa ser um horário maior do que a maioria das durações de viagem. para por exemplo, uma hora.

Os resultados dessa solicitação incluem viagens que não são COMPLETE nem CANCELED e não são atualizadas há mais de uma hora. Você pode então examinar essas viagens para garantir que o status delas no Fleet Engine seja atualizado corretamente.

A seguir