این نوعی از متد locations.optimizeToursLongRunning است که برای بهینهسازیهایی با مقادیر timeout بزرگ و اندازههای ورودی/خروجی بزرگ طراحی شده است.
کلاینت، URI مربوط به OptimizeToursRequest ذخیره شده در Google Cloud Storage را مشخص میکند و سرور، OptimizeToursResponse را در یک URI مربوط به Google Cloud Storage که توسط کلاینت تعیین شده است، مینویسد.
این روش باید نسبت به روش locations.optimizeTours برای بهینهسازیهایی که بیش از چند دقیقه طول میکشند و اندازههای ورودی/خروجی بزرگتر از ۸ مگابایت هستند، ترجیح داده شود، اگرچه میتوان از آن برای بهینهسازیهای کوتاهتر و کوچکتر نیز استفاده کرد.
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 از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
parent | الزامی. پروژه یا مکان مورد نظر برای برقراری تماس. قالب:
اگر هیچ مکانی مشخص نشده باشد، یک منطقه به طور خودکار انتخاب میشود. |
درخواست بدنه
بدنه درخواست شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{ "input": { object ( |
| فیلدها | |
|---|---|
input | الزامی. آدرس اینترنتی (URI) شیء Cloud Storage که شامل |
output | الزامی. آدرس اینترنتی (URI) شیء ذخیرهسازی ابری که شامل |
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ شامل نمونهای از Operation است.
دامنههای مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/cloud-platform
مجوزهای IAM
به مجوز IAM زیر در منبع parent نیاز دارد:
-
routeoptimization.operations.create
برای اطلاعات بیشتر، به مستندات IAM مراجعه کنید.