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 ได้รับการอัปเดตอย่างถูกต้อง