Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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_id precisa estar vazio.
active_trips_only precisa ser true.
minimum_staleness precisa 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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-13 UTC."],[[["\u003cp\u003eFleet Engine's \u003ccode\u003eSearchTripsRequest\u003c/code\u003e helps find trips, useful for identifying active trips and reconciling vehicle availability.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003eSearchTripsRequest\u003c/code\u003e with \u003ccode\u003evehicle_id\u003c/code\u003e and \u003ccode\u003eactive_trips_only\u003c/code\u003e to find a specific vehicle's active trips.\u003c/p\u003e\n"],["\u003cp\u003eDiscrepancies between your system and Fleet Engine's vehicle availability can be addressed by using \u003ccode\u003eSearchTripsRequest\u003c/code\u003e to identify open trips and ensure trip statuses are synchronized.\u003c/p\u003e\n"],["\u003cp\u003eTrips older than 7 days are automatically deleted in Fleet Engine.\u003c/p\u003e\n"]]],["The `SearchTripsRequest` endpoint in Fleet Engine allows finding trips, focusing on two scenarios. First, setting `vehicle_id` and `active_trips_only` to `true` identifies active trips for a specific vehicle. Second, to reconcile vehicle availability, `vehicle_id` is left empty, `active_trips_only` is `true`, and `minimum_staleness` is set to over an hour. This identifies open, outdated trips (neither `COMPLETE` nor `CANCELED`) for status reconciliation. Trips are only searchable for seven days.\n"],null,[]]
