گشتهای خودرو را برای یک یا چند پیام 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 |
الزامی. پروژه و مکان هدف برای برقراری تماس. قالب:
مقادیر منطقهای |
متن درخواست
بدنه درخواست حاوی دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{
"modelConfigs": [
{
object ( |
| فیلدها | |
|---|---|
modelConfigs[] |
الزامی. اطلاعات ورودی/خروجی هر مدل خرید، مانند مسیرهای فایل و قالبهای داده. |
بدنه پاسخ
اگر موفقیتآمیز باشد، بدنه پاسخ حاوی نمونهای از Operation است.
دامنههای مجوز
به محدوده OAuth زیر نیاز دارد:
https://www.googleapis.com/auth/cloud-platform
اجازههای IAM
به اجازه IAM زیر در منبع parent نیاز دارد:
routeoptimization.operations.create
برای اطلاعات بیشتر، به اسناد IAM مراجعه کنید.