Method: projects.batchOptimizeTours

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

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

يمكن للمستخدم الاستعلام عن operations.get للتحقّق من حالة طلب الحصول على إذن الوصول إلى البيانات غير القابلة للتغيير:

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

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

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