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