Method: projects.locations.optimizeToursUri

วิธีนี้เป็นรูปแบบหนึ่งของเมธอด locations.optimizeToursLongRunning ที่ออกแบบมาเพื่อการเพิ่มประสิทธิภาพที่มีค่าการหมดเวลาขนาดใหญ่และขนาดอินพุต/เอาต์พุตขนาดใหญ่

โดยไคลเอ็นต์จะระบุ URI ของ OptimizeToursRequest ที่เก็บไว้ใน Google Cloud Storage และเซิร์ฟเวอร์จะเขียน OptimizeToursResponse ไปยัง URI ของ Google Cloud Storage ที่ไคลเอ็นต์ระบุ

คุณควรใช้วิธีนี้แทนวิธี locations.optimizeTours สําหรับการเพิ่มประสิทธิภาพที่ใช้เวลานานกว่า 2-3 นาทีและขนาดอินพุต/เอาต์พุตที่มากกว่า 8 MB แม้ว่าจะใช้สําหรับการเพิ่มประสิทธิภาพที่ใช้เวลาสั้นลงและขนาดไฟล์เล็กลงได้เช่นกัน

long-running operation (LRO) ที่แสดงผลจะมีชื่อในรูปแบบ <parent>/operations/<operation_id> และใช้ติดตามความคืบหน้าของการคํานวณได้ ประเภทฟิลด์ metadata คือ OptimizeToursLongRunningMetadata ประเภทฟิลด์ response คือ OptimizeToursUriResponse หากดำเนินการสำเร็จ

เวอร์ชันทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/tt/route-optimization/experimental/otlr/make-request

คำขอ HTTP

POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}:OptimizeToursUri

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ต้องระบุ โปรเจ็กต์หรือสถานที่เป้าหมายที่จะโทร

รูปแบบ: * projects/{project-id} * projects/{project-id}/locations/{location-id}

หากไม่ได้ระบุสถานที่ ระบบจะเลือกภูมิภาคโดยอัตโนมัติ

เนื้อความของคำขอ

เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "input": {
    object (Uri)
  },
  "output": {
    object (Uri)
  }
}
ช่อง
input

object (Uri)

ต้องระบุ URI ของออบเจ็กต์ Cloud Storage ที่มี OptimizeToursRequest
output

object (Uri)

ต้องระบุ URI ของออบเจ็กต์ Cloud Storage ที่จะมี OptimizeToursResponse

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Operation

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform

สิทธิ์ IAM

ต้องมีสิทธิ์ IAM ต่อไปนี้ในทรัพยากร parent

  • routeoptimization.operations.create

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบ IAM