Method: projects.batchOptimizeTours

تحسِّن هذه الطريقة جولات المركبات لرسالة واحدة أو أكثر من رسائل OptimizeToursRequest كدفعة.

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

يمكن للمستخدم إجراء استطلاع على operations.get للتحقّق من حالة العملية الطويلة الأمد:

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

إذا كان الحقل 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

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

يتطلّب ذلك إذن إدارة الهوية وإمكانية الوصول التالي في المورد parent:

  • routeoptimization.operations.create

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