Method: projects.batchOptimizeTours

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

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

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

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

إذا كان حقل LRO done صحيحًا، يعني ذلك أنّه تمت معالجة جميع الطلبات. وستُتاح نتائج أي طلبات تمت معالجتها بنجاح في فريق GCS. ولن تكون نتائج أي طلبات تعذّر تنفيذها متاحة في GCS. إذا تم ضبط حقل 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

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

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

  • routeoptimization.operations.create

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