Method: projects.locations.batchOptimizeTours

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

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

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

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

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

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