Method: projects.batchOptimizeTours

تحسين جولات المركبة لرسالة واحدة أو أكثر OptimizeToursRequest كمجموعة

هذه الطريقة هي عملية طويلة الأمد (LRO). تتم قراءة مدخلات التحسين (رسائل OptimizeToursRequest) ومخرجاته (رسائل OptimizeToursResponse) وكتابتها في Cloud Storage بالتنسيق الذي يحدّده المستخدم. على غرار طريقة projects.optimizeTours، تحتوي كل OptimizeToursRequest على ShipmentModel وتعرض OptimizeToursResponse تحتوي على حقول ShipmentRoute، وهي مجموعة من المسارات التي يجب أن تسلكها المركبات لخفض التكلفة الإجمالية.

يمكن للمستخدم إجراء عملية بحث operations.get للتحقّق من حالة عملية LRO:

إذا كان حقل done LRO بقيمة false، يعني ذلك أنّه لا يزال يتمّ معالجة طلب واحد على الأقلّ. قد تكون الطلبات الأخرى قد اكتملت بنجاح وتتوفّر نتائجها في Cloud Storage.

إذا كان الحقل done الخاص بممثل الجهة المحلية صحيحًا، يعني ذلك أنّه تمت معالجة جميع الطلبات. ستتوفّر نتائج أي طلبات تمت معالجتها بنجاح في Cloud Storage. لن تتوفّر نتائج أي طلبات لم تتم معالجتها في Cloud Storage. إذا تم ضبط الحقل error الخاص بـ LRO، سيتضمّن الخطأ الناتج عن أحد الطلبات التي تعذّر تنفيذها.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى 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) التالي على مورد parent:

  • routeoptimization.operations.create

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات إدارة الهوية وإمكانية الوصول.