ค้นหาการเดินทาง

Fleet Engine มีปลายทาง SearchTripsRequest ที่คุณใช้ค้นหาการเดินทางได้ เอกสารนี้อธิบาย 2 สถานการณ์ที่คุณอาจใช้ฟีเจอร์นี้

ดู SearchTripsRequest สำหรับ gRPC หรือ trips.Search สำหรับ REST

กำหนดการเดินทางที่ใช้งานได้สำหรับยานพาหนะ

หากต้องการค้นหาการเดินทางที่ใช้งานได้สำหรับช่องที่เฉพาะเจาะจง ให้ใช้ข้อความ SearchTripsRequest เพื่อตั้งค่า vehicle_id เป็นยานพาหนะที่ต้องการและตั้งค่า active_trips_only เป็น true

ปรับความพร้อมให้บริการของยานพาหนะระหว่างระบบของคุณกับ Fleet Engine

ในบางสถานการณ์ คุณอาจเห็นผลลัพธ์ที่แสดงโดย SearchVehicles ซึ่งไม่ตรงกับยานพาหนะที่คุณทราบว่าพร้อมให้บริการในระบบและกลุ่มยานพาหนะของคุณ กรณีนี้เกิดขึ้นเนื่องจาก SearchVehicles ไม่แสดงยานพาหนะที่มีการเดินทางที่ใช้งานได้ หรือเลื่อนยานพาหนะเหล่านั้นลงในการจัดอันดับผลการค้นหา สาเหตุหนึ่งคือยานพาหนะทำการเดินทางเสร็จแล้ว แต่สถานะการเดินทางไม่ได้ตั้งค่าเป็น COMPLETE หรือ CANCELED อย่างถูกต้อง การใช้ SearchTrips เพื่อค้นหาการเดินทางที่เปิดอยู่จะช่วยให้คุณประเมินยานพาหนะเพื่อให้แน่ใจว่า TripStatus ในระบบของคุณตรงกับสถานะใน Fleet Engine

หากต้องการใช้ SearchTrips ในลักษณะนี้ ให้ตั้งค่าต่อไปนี้ในข้อความ SearchTripsRequest

  • vehicle_id ควรว่างเปล่า
  • active_trips_only ควรเป็น true
  • minimum_staleness ควรเป็นเวลาที่นานกว่าระยะเวลาการเดินทางส่วนใหญ่ เช่น 1 ชั่วโมง

ผลลัพธ์ของคำขอดังกล่าวรวมถึงการเดินทางที่ไม่ได้มีสถานะเป็น COMPLETE หรือ CANCELED และไม่ได้อัปเดตมานานกว่า 1 ชั่วโมง จากนั้นคุณสามารถตรวจสอบการเดินทางเหล่านี้เพื่อให้แน่ใจว่าสถานะใน Fleet Engine ได้รับการอัปเดตอย่างถูกต้อง

ขั้นตอนถัดไป