ปลายทางแบบซิงโครนัสและแบบอะซิงโครนัส

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

Route Optimization API มี 2 เมธอด ดังนี้

  • OptimizeTours เป็นเมธอด ซิงโครนัส ที่แสดงผลเส้นทางที่เพิ่มประสิทธิภาพแล้วเพื่อตอบสนองต่อ OptimizeToursRequest ไคลเอ็นต์ต้องรักษาการเชื่อมต่อกับ Route Optimization API ไว้จนกว่าระบบจะประมวลผลคำขอและแสดงผล OptimizeToursResponse หรือข้อผิดพลาด
  • BatchOptimizeTours เป็นเมธอด อะซิงโครนัส ที่รับ URI สำหรับข้อความ OptimizeToursRequest อย่างน้อย 1 รายการและข้อความ OptimizeToursResponse ที่เกี่ยวข้อง โดยจะแสดงผลชื่อทรัพยากรของ การดำเนินการที่ทำงานเป็นเวลานาน (LRO) (REST, gRPC) ซึ่งใช้เพื่อตรวจสอบการดำเนินการเป็นชุดให้เสร็จสมบูรณ์ ระบบจะประมวลผล OptimizeToursRequest ในเบื้องหลัง ดังนั้นไคลเอ็นต์จึงรักษา การเชื่อมต่อกับ Route Optimization API ไว้เพียงนานพอที่จะส่ง BatchOptimizeToursRequest หรือเรียก GetOperation เพื่อตรวจสอบสถานะ LRO BatchOptimizeTours อ่านคำขอจากและเขียนการตอบกลับไปยัง Google Cloud Storage

กรณีการใช้งาน

OptimizeTours เหมาะสำหรับการแก้ปัญหาคำขอขนาดเล็กและเรียบง่าย หรือคำขอที่ใช้เวลาแก้ปัญหาไม่กี่นาทีหรือน้อยกว่า การรักษาการเชื่อมต่อระยะเวลานานกับ Route Optimization API จะเพิ่มความเสี่ยงที่จะเกิดการหยุดชะงักก่อนที่จะแสดงผลโซลูชันได้

BatchOptimizeTours สามารถจัดการคำขอขนาดใหญ่และคำขอที่ใช้เวลาแก้ปัญหานานขึ้นได้เนื่องจากไม่จำเป็นต้องมีการเชื่อมต่อระยะเวลานานกับ Route Optimization API

การดำเนินการที่ทำงานเป็นเวลานาน

อ่าน LRO จาก Route Optimization API โดยใช้เมธอด GetOperation เพื่อตรวจสอบสถานะการดำเนินการเป็นชุดให้เสร็จสมบูรณ์ LRO มีพร็อพเพอร์ตี้ done ที่ระบุว่าการประมวลผลทั้งชุดเสร็จสมบูรณ์แล้วหรือไม่ และช่อง error ที่รายงานข้อผิดพลาดที่พบระหว่างการประมวลผล หาก done เป็น "จริง" และไม่มี error แสดงว่าการดำเนินการเป็นชุดเสร็จสมบูรณ์แล้ว การมี error แสดงว่าการประมวลผลเป็นชุดบางส่วนหรือทั้งหมดล้มเหลว

วงจรทั่วไปของคำขอ BatchOptimizeTours มีดังนี้

  1. ส่ง BatchOptimizeToursRequest ไปยัง Route Optimization API ซึ่งจะแสดงผลชื่อทรัพยากรของ LRO
  2. โพล GetOperation ด้วยชื่อทรัพยากร LRO ที่แสดงผลจนกว่าพร็อพเพอร์ตี้ done หรือ error จะปรากฏในการตอบกลับ LRO
  3. หาก done เป็น "จริง" และไม่มีข้อผิดพลาด ให้อ่าน OptimizeToursResponses จาก URI ของ Google Cloud Storage ที่ระบุไว้ในคำขอ BatchOptimizeTours หากมี error ให้ตรวจสอบข้อผิดพลาด อัปเดต OptimizeToursRequest ที่เกี่ยวข้องใน Google Cloud Storage และลองอีกครั้งตามความเหมาะสมโดยขึ้นอยู่กับข้อผิดพลาดที่พบ

คุณสามารถส่งคำขอ OptimizeTours และ BatchOptimizeTours ได้หลาย วิธี ไม่ว่าจะจากบรรทัดคำสั่งหรือใช้ไลบรารีของไคลเอ็นต์

ถัดไป: ส่งคำขอ API