Method: projects.locations.batchOptimizeTours

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

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

يمكن للمستخدم استطلاع رأي operations.get للتحقُّق من حالة LRO:

إذا كان حقل LRO done غير صحيح، يعني ذلك أنّ هناك طلبًا واحدًا على الأقل لا يزال قيد المعالجة. قد تكون الطلبات الأخرى قد اكتملت بنجاح وتتوفر نتائجها في "مساحة التخزين في السحابة الإلكترونية".

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

طلب HTTP

POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}: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

أذونات إدارة الهوية وإمكانية الوصول

يجب الحصول على إذن إدارة الهوية وإمكانية الوصول التالي في مورد "parent":

  • routeoptimization.operations.create

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