Method: projects.optimizeToursUri

هذه طريقة مختلفة عن طريقة projects.optimizeToursLongRunning وهي مصمّمة للتحسينات التي تتضمّن قيم مهلة كبيرة وحجم إدخال/إخراج كبير.

يحدِّد العميل معرّف الموارد المنتظم (URI) لملف OptimizeToursRequest المخزَّن في Google Cloud Storage، ويكتب الخادم OptimizeToursResponse في معرّف الموارد المنتظم (URI) الذي يحدِّده العميل في Google Cloud Storage.

يجب تفضيل هذه الطريقة على طريقة projects.optimizeTours للتحسينات التي تستغرق أكثر من بضع دقائق وحجم الإدخال/الإخراج أكبر من 8 ميغابايت، على الرغم من أنّه يمكن استخدامها أيضًا للتحسينات الأقصر والأصغر حجمًا.

سيكون للعنصر long-running operation (LRO) الذي يتم إرجاعه اسم بالتنسيق <parent>/operations/<operation_id> ويمكن استخدامه لتتبُّع مستوى تقدّم عملية الحساب. نوع الحقل metadata هو OptimizeToursLongRunningMetadata. نوع الحقل response هو OptimizeToursUriResponse، في حال نجاح العملية.

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/tt/route-optimization/experimental/otlr/make-request للحصول على مزيد من التفاصيل.

طلب HTTP

POST https://routeoptimization.googleapis.com/v1/{parent=projects/*}:OptimizeToursUri

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

مطلوب. استهدِف المشروع أو الموقع الجغرافي لإجراء مكالمة.

التنسيق: * projects/{project-id} * projects/{project-id}/locations/{location-id}

في حال عدم تحديد موقع جغرافي، سيتم اختيار منطقة تلقائيًا.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "input": {
    object (Uri)
  },
  "output": {
    object (Uri)
  }
}
الحقول
input

object (Uri)

مطلوب. معرّف الموارد المنتظم لعنصر Cloud Storage الذي يحتوي على OptimizeToursRequest.
output

object (Uri)

مطلوب. معرّف الموارد المنتظم (URI) لعنصر Cloud Storage الذي سيحتوي على OptimizeToursResponse.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform

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

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

  • routeoptimization.operations.create

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