تورهای خودرو را برای یک یا چند پیام OptimizeToursRequest به صورت دستهای بهینه میکند.
این متد یک عملیات طولانی مدت (LRO) است. ورودیهای بهینهسازی (پیامهای OptimizeToursRequest ) و خروجیها (پیامهای OptimizeToursResponse ) از Cloud Storage خوانده شده و در قالب مشخص شده توسط کاربر در آن نوشته میشوند. مانند متد projects.optimizeTours ، هر OptimizeToursRequest شامل یک ShipmentModel است و یک OptimizeToursResponse حاوی فیلدهای ShipmentRoute را برمیگرداند که مجموعهای از مسیرهایی هستند که باید توسط وسایل نقلیه انجام شوند و هزینه کلی را به حداقل برسانند.
کاربر میتواند برای بررسی وضعیت LRO از operations.get نظرسنجی کند:
اگر فیلد done » در LRO نادرست باشد، حداقل یک درخواست هنوز در حال پردازش است. ممکن است درخواستهای دیگر با موفقیت انجام شده باشند و نتایج آنها در فضای ذخیرهسازی ابری موجود باشد.
اگر فیلد done مربوط به LRO برابر با true باشد، تمام درخواستها پردازش شدهاند. نتایج هر درخواستی که با موفقیت پردازش شود، در Cloud Storage قابل دسترسی خواهد بود. نتایج هر درخواستی که با شکست مواجه شود، در Cloud Storage قابل دسترسی نخواهد بود. اگر فیلد error مربوط به LRO تنظیم شده باشد، شامل خطای یکی از درخواستهای ناموفق خواهد بود.
درخواست HTTP
POST https://routeoptimization.googleapis.com/v1/{parent=projects/*}:batchOptimizeTours
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
parent | الزامی. پروژه و مکان مورد نظر برای برقراری تماس. قالب:
اگر هیچ مکانی مشخص نشده باشد، یک منطقه به طور خودکار انتخاب میشود. |
درخواست بدنه
بدنه درخواست شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{
"modelConfigs": [
{
object ( |
| فیلدها | |
|---|---|
modelConfigs[] | الزامی. اطلاعات ورودی/خروجی برای هر مدل خرید، مانند مسیر فایلها و فرمتهای داده. |
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ شامل نمونهای از Operation است.
دامنههای مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/cloud-platform
مجوزهای IAM
به مجوز IAM زیر در منبع parent نیاز دارد:
-
routeoptimization.operations.create
برای اطلاعات بیشتر، به مستندات IAM مراجعه کنید.