Method: projects.batchOptimizeTours

گشت‌های خودرو را برای یک یا چند پیام OptimizeToursRequest به‌صورت دسته‌ای بهینه‌سازی می‌کند.

این روش یک «عملیات طولانی‌مدت» (LRO) است. ورودی‌های بهینه‌سازی (پیام‌های OptimizeToursRequest) و خروجی‌ها (پیام‌های OptimizeToursResponse) با قالب مشخص‌شده توسط کاربر از Cloud Storage خوانده و در آن نوشته می‌شوند. مانند روش projects.optimizeTours، هر OptimizeToursRequest حاوی یک ShipmentModel است و یک OptimizeToursResponse حاوی فیلدهای ShipmentRoute را برمی‌گرداند که مجموعه‌ای از مسیرهایی هستند که باید توسط وسایل نقلیه انجام شوند تا هزینه کلی به حداقل برسد.

کاربر می‌تواند operations.get را نظرسنجی کند تا وضعیت LRO را بررسی کند:

اگر فیلد LRO done نادرست باشد، حداقل یک درخواست هنوز درحال پردازش است. ممکن است درخواست‌های دیگر با موفقیت تکمیل شده باشند و نتایج آن‌ها در Cloud Storage دردسترس باشد.

اگر فیلد done مربوط به LRO درست باشد، همه درخواست‌ها پردازش شده‌اند. نتایج هر درخواستی که با موفقیت پردازش شود در Cloud Storage دردسترس خواهد بود. نتایج درخواست‌های ناموفق در Cloud Storage دردسترس نخواهد بود. اگر فیلد error مربوط به LRO تنظیم شده باشد، حاوی خطای یکی از درخواست‌های ناموفق است.

درخواست HTTP

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

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
parent

string

الزامی. پروژه و مکان هدف برای برقراری تماس.

قالب:

  • projects/{project-id}
  • projects/{project-id}/locations/-

مقادیر منطقه‌ای {location-id} پشتیبانی نمی‌شود.

متن درخواست

بدنه درخواست حاوی داده‌هایی با ساختار زیر است:

نمایش JSON
{
  "modelConfigs": [
    {
      object (AsyncModelConfig)
    }
  ]
}
فیلدها
modelConfigs[]

object (AsyncModelConfig)

الزامی. اطلاعات ورودی/خروجی هر مدل خرید، مانند مسیرهای فایل و قالب‌های داده.

بدنه پاسخ

اگر موفقیت‌آمیز باشد، بدنه پاسخ حاوی نمونه‌ای از Operation است.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

اجازه‌های IAM

به اجازه IAM زیر در منبع parent نیاز دارد:

  • routeoptimization.operations.create

برای اطلاعات بیشتر، به اسناد IAM مراجعه کنید.