Method: projects.locations.optimizeToursUri

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

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

يجب تفضيل هذه الطريقة على الطريقة locations.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/*/locations/*}:OptimizeToursUri

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

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

المعلمات
parent

string

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

التنسيق:

  • projects/{project-id}
  • projects/{project-id}/locations/{location-id}

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

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

object (Uri)

الحقل مطلوب. معرّف الموارد المنتظم (URI) لكائن Cloud Storage الذي يحتوي على OptimizeToursRequest
output

object (Uri)

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

نص الاستجابة

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

نطاقات الأذونات

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

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

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

يتطلّب هذا الإجراء إذن إدارة الهوية وإمكانية الوصول (IAM) التالي على مورد parent:

  • routeoptimization.operations.create

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