여행 검색

Fleet Engine은 이동을 찾는 데 사용할 수 있는 SearchTripsRequest 엔드포인트를 제공합니다. 이 문서에서는 이 기능을 사용할 수 있는 두 가지 시나리오를 설명합니다.

gRPC의 경우 SearchTripsRequest를, REST의 경우 trips.Search을 참고하세요.

차량의 활성 여정을 확인합니다.

특정 필드의 활성 여행을 찾으려면 SearchTripsRequest 메시지를 사용하여 vehicle_id을 고려 중인 차량으로 설정하고 active_trips_only을 true로 설정합니다.

시스템과 Fleet Engine 간 차량 재고 조정

경우에 따라 시스템과 차량에서 사용할 수 있는 것으로 알려진 차량과 일치하지 않는 결과가 SearchVehicles에 의해 반환될 수 있습니다. 이는 SearchVehicles에서 활성 여정이 있는 차량을 표시하지 않거나 결과 순위에서 아래로 푸시하기 때문입니다. 이러한 문제의 한 가지 원인은 차량이 이동을 완료했지만 이동 상태가 COMPLETE 또는 CANCELED으로 제대로 설정되지 않은 경우입니다. SearchTrips를 사용하여 진행 중인 여정을 찾으면 차량을 평가하여 시스템의 TripStatus이 Fleet Engine의 TripStatus과 일치하는지 확인할 수 있습니다.

이 방식으로 SearchTrips를 사용하려면 SearchTripsRequest 메시지에서 다음을 설정하세요.

  • vehicle_id는 비어 있어야 합니다.
  • active_trips_only은 true여야 합니다.
  • minimum_staleness는 대부분의 이동 시간보다 긴 시간이어야 합니다(예: 1시간).

이러한 요청의 결과에는 COMPLETE도 CANCELED도 아니며 1시간 넘게 업데이트되지 않은 경로가 포함됩니다. 그런 다음 이러한 여정을 검사하여 Fleet Engine의 상태가 올바르게 업데이트되었는지 확인할 수 있습니다.

다음 단계