هذا هو أحد أشكال طريقة projects.optimizeTours
المصمّمة للتحسينات التي تستخدم قيم مهلة كبيرة. ويجب تفضيلها على طريقة projects.optimizeTours
للتحسينات التي تستغرق أكثر من بضع دقائق.
سيكون للعنصر long-running operation
(LRO) الذي يتم إرجاعه اسم بالتنسيق <parent>/operations/<operation_id>
ويمكن استخدامه لتتبُّع مستوى تقدّم عملية الحساب. نوع الحقل metadata
هو OptimizeToursLongRunningMetadata
. نوع الحقل response
هو OptimizeToursResponse
، في حال نجاح العملية.
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/tt/route-optimization/experimental/otlr/make-request للحصول على مزيد من التفاصيل.
طلب HTTP
POST https://routeoptimization.googleapis.com/v1/{parent=projects/*}:optimizeToursLongRunning
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
مطلوب. استهدِف المشروع أو الموقع الجغرافي لإجراء مكالمة. التنسيق: * في حال عدم تحديد موقع جغرافي، سيتم اختيار منطقة تلقائيًا. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "timeout": string, "model": { object ( |
الحقول | |
---|---|
timeout |
في حال ضبط هذه المهلة، يعرض الخادم استجابة قبل انقضاء فترة المهلة أو بلوغ الموعد النهائي للخادم للطلبات المتزامنة، أيهما أقرب. بالنسبة إلى الطلبات غير المتزامنة، سينشئ الخادم حلًا (إن أمكن) قبل انقضاء مهلة الانتظار. المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
model |
نموذج الشحن لحلّ المشكلة |
solvingMode |
يكون وضع الحل تلقائيًا هو |
searchMode |
وضع البحث المستخدَم لحلّ الطلب |
injectedFirstSolutionRoutes[] |
توجيه خوارزمية التحسين في العثور على حلّ أوّل مشابه لحلّ سابق يتم تقييد النموذج عند إنشاء الحلّ الأول. يتمّ بشكل ضمني تخطّي أيّ شحنات لم يتمّ تنفيذها على مسار معيّن في الحلّ الأول، ولكن قد يتمّ تنفيذها في الحلول اللاحقة. يجب أن يستوفي الحلّ بعض الافتراضات الأساسية للصلاحية:
إذا لم يكن الحلّ المُدرَج قابلاً للتطبيق، لا يعني ذلك بالضرورة ظهور خطأ في عملية التحقّق، بل قد يظهر خطأ يشير إلى عدم قابلية الحلّ للتطبيق. |
injectedSolutionConstraint |
فرض قيود على خوارزمية التحسين للعثور على حل نهائي مشابه لحلّ سابق على سبيل المثال، يمكن استخدام هذا الإجراء لتجميد أجزاء من المسارات التي سبق إكمالها أو التي سيتم إكمالها ولكن يجب عدم تعديلها. إذا لم يكن الحلّ المُدرَج قابلاً للتطبيق، لا يعني ذلك بالضرورة ظهور خطأ في عملية التحقّق، بل قد يظهر خطأ يشير إلى عدم قابلية الحلّ للتطبيق. |
refreshDetailsRoutes[] |
إذا لم تكن فارغة، سيتمّ تعديل المسارات المحدّدة بدون تعديل تسلسل الزيارات أو أوقات التنقّل الأساسية: سيتمّ تعديل التفاصيل الأخرى فقط. لا يؤدي ذلك إلى حلّ المشكلة في النموذج. اعتبارًا من تشرين الثاني (نوفمبر) 2020، لا يتمّ ملء خطوط البوليجون إلا للمسارات غير الفارغة، ويتطلّب ذلك ضبط قد تكون حقول يجب عدم استخدام هذا الحقل مع لا يؤثّر الخياران |
interpretInjectedSolutionsUsingLabels |
إذا كان صحيحًا:
ينطبق هذا التفسير على الحقول إذا كانت القيمة هي true، يجب أن تظهر التصنيفات في الفئات التالية مرة واحدة فقط في فئتها:
إذا لم يكن قد تؤدي إزالة زيارات المسار أو مسارات كاملة من حلّ تمّت حقنه إلى التأثير في القيود الضمنية، ما قد يؤدي إلى تغيير في الحلّ أو أخطاء في التحقّق أو عدم القابلية للتنفيذ. ملاحظة: على المتصل التأكّد من أنّ كل |
considerRoadTraffic |
ننصحك بالأخذ في الاعتبار تقدير عدد الزيارات عند احتساب حقول |
populatePolylines |
إذا كان صحيحًا، ستتم تعبئة الخطوط المتعددة في |
populateTransitionPolylines |
إذا كانت القيمة "صحيح"، سيتم تعبئة الخطوط المتعددة ورموز المسارات في الاستجابة |
allowLargeDeadlineDespiteInterruptionRisk |
في حال ضبط هذا الخيار، يمكن أن يكون للطلب مهلة (راجِع https://grpc.io/blog/deadlines) تصل إلى 60 دقيقة. بخلاف ذلك، تكون المهلة القصوى 30 دقيقة فقط. يُرجى العِلم أنّ الطلبات التي تستمر لفترة طويلة تكون أكثر عرضة للانقطاع (ولكن بنسبة صغيرة). |
useGeodesicDistances |
إذا كانت القيمة صحيحة، سيتم احتساب مسافات التنقّل باستخدام المسافات الجيوديسية بدلاً من مسافات "خرائط Google"، وسيتم احتساب أوقات التنقّل باستخدام المسافات الجيوديسية بسرعة محدّدة بواسطة |
label |
التصنيف الذي يمكن استخدامه لتحديد هذا الطلب، والذي تم الإبلاغ عنه في |
geodesicMetersPerSecond |
عندما تكون قيمة |
maxValidationErrors |
تقتطع عدد أخطاء التحقّق من الصحة التي يتم عرضها. يتم عادةً إرفاق هذه الأخطاء بحمولة خطأ INVALID_ARGUMENT كتفاصيل خطأ BadRequest (https://cloud.google.com/apis/design/errors#error_details)، ما لم يكن solvingMode=VALIDATE_ONLY: راجِع الحقل |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/cloud-platform
أذونات إدارة الهوية وإمكانية الوصول
يتطلب إذن إدارة الهوية وإمكانية الوصول التالي على مورد parent
:
routeoptimization.operations.create
لمزيد من المعلومات، يُرجى الاطّلاع على مستندات إدارة الهوية وإمكانية الوصول.