لإرسال OptimizeToursRequest
تحتوي على ShipmentModel
وعرض OptimizeToursResponse
تحتوي على ShipmentRoute
، وهي مجموعة من المسارات التي يمكن للمركبات تنفيذها مع تقليل التكلفة الإجمالية.
يتكوّن نموذج ShipmentModel
بشكلٍ أساسي من Shipment
التي يجب تنفيذها وVehicle
s التي يمكن استخدامها لنقل Shipment
. وتعيّن ShipmentRoute
عناصر Shipment
إلى Vehicle
. وبشكل أكثر تحديدًا، يخصّصون سلسلة من Visit
لكل مركبة، حيث تتوافق السمة Visit
مع سمة VisitRequest
، وهي عملية استلام أو توصيل لـ Shipment
.
والهدف من ذلك هو توفير تخصيص ShipmentRoute
إلى Vehicle
، ما يقلّل من إجمالي التكلفة حيث تكون التكلفة محددة في ShipmentModel
.
طلب HTTP
POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}:optimizeTours
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
مطلوب. استهدف المشروع أو الموقع الجغرافي لإجراء مكالمة. التنسيق: * في حال عدم تحديد أي موقع جغرافي، سيتم اختيار منطقة تلقائيًا. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "timeout": string, "model": { object ( |
الحقول | |
---|---|
timeout |
إذا تم ضبط هذه المهلة، يعرض الخادم استجابة قبل انقضاء مدة المهلة أو بلوغ الموعد النهائي للخادم لتنفيذ الطلبات المتزامنة، أيهما أقرب. بالنسبة إلى الطلبات غير المتزامنة، سينشئ الخادم حلاً (إن أمكن) قبل انقضاء المهلة. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
model |
نموذج الشحن المطلوب حلّه |
solvingMode |
بشكل تلقائي، يكون وضع الحل هو |
searchMode |
وضع البحث المُستخدَم لحل الطلب |
injectedFirstSolutionRoutes[] |
توجيه خوارزمية التحسين للعثور على حل أول مشابه لحل سابق. يصبح النموذج مقيدًا عند إنشاء الحل الأول. يتم ضمنيًا تخطي أي شحنات لا يتم إجراؤها على المسار في الحل الأول، ولكن قد يتم إجراؤها في حلول متتالية. يجب أن يستوفي الحل بعض افتراضات الصلاحية الأساسية:
وإذا لم يكن الحل الذي تم إدخاله قابلاً للتنفيذ، لا يتم بالضرورة عرض خطأ في عملية التحقّق وقد يتم عرض خطأ يشير إلى عدم الجدوى بدلاً من ذلك. |
injectedSolutionConstraint |
تقييد خوارزمية التحسين لإيجاد حل نهائي مشابه لحل سابق. على سبيل المثال، يمكن استخدام ذلك لتجميد أجزاء من المسارات التي تم إكمالها من قبل أو التي سيتم إكمالها ولكن يجب عدم تعديلها. وإذا لم يكن الحل الذي تم إدخاله قابلاً للتنفيذ، لا يتم بالضرورة عرض خطأ في عملية التحقّق وقد يتم عرض خطأ يشير إلى عدم الجدوى بدلاً من ذلك. |
refreshDetailsRoutes[] |
وإذا لم يكن الحقل فارغًا، سيتم تحديث المسارات بدون تعديل التسلسل الأساسي للزيارات أو مُدد السفر: سيتم تعديل التفاصيل الأخرى فقط. وهذا لا يؤدي إلى حل النموذج. اعتبارًا من 2020/11، لن يؤدي ذلك إلا إلى تعبئة الخطوط المتعددة للمسارات غير الفارغة ويتطلب ضبط سياسة قد تكون الحقول يجب عدم استخدام هذا الحقل مع ولا يؤثر |
interpretInjectedSolutionsUsingLabels |
إذا كانت القيمة هي true:
ينطبق هذا التفسير على الحقول إذا كانت القيمة هي true، يجب أن تظهر التصنيفات في الفئات التالية مرة واحدة كحدّ أقصى في فئتها:
إذا كانت وقد يكون لإزالة زيارات المسارات أو المسارات بالكامل من الحل الذي تم إدخاله تأثير على القيود الضمنية، ما قد يؤدي إلى تغيير الحل أو حدوث أخطاء في التحقّق أو عدم الجدوى. ملاحظة: يجب أن يتأكد المتصل من أن كل |
considerRoadTraffic |
ننصحك باستخدام تقدير عدد الزيارات عند احتساب الحقول |
populatePolylines |
في حال كانت القيمة "صحيح"، ستتم تعبئة الخطوط المتعددة في الردود |
populateTransitionPolylines |
في حال كانت القيمة "صحيح"، ستتم تعبئة الخطوط المتعددة في الاستجابة |
allowLargeDeadlineDespiteInterruptionRisk |
وفي حال ضبط هذه السياسة، يمكن أن يتم تحديد موعد نهائي للطلب (راجِع https://grpc.io/blog/deadlines) يصل إلى 60 دقيقة. وبخلاف ذلك، يبلغ الحد الأقصى للموعد النهائي 30 دقيقة فقط. وتجدر الإشارة إلى أنّ الطلبات طويلة الأجل تنطوي على خطر أكبر بكثير (ولكنّه لا يزال بسيطًا). |
useGeodesicDistances |
في حال الضبط على "صحيح"، سيتم احتساب مسافات السفر باستخدام المسافات الجيوديسية بدلاً من المسافات في "خرائط Google"، وسيتم احتساب مدّة التنقّل باستخدام المسافات الجيوديسية مع السرعة التي تحدّدها |
label |
تصنيف يمكن استخدامه لتحديد هذا الطلب، وتم الإبلاغ عنه في |
geodesicMetersPerSecond |
عند ضبط |
maxValidationErrors |
لاقتطاع عدد أخطاء التحقق من الصحة التي تم عرضها. عادةً ما ترتبط هذه الأخطاء بحمولة خطأ INSERT_SELECTED كتفصيل لخطأ BadRequest (https://cloud.google.com/apis/design/errors#error_details)، ما لم يكن SolutionMode=VALIDATE_ONLY: يُرجى الاطّلاع على الحقل |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال OptimizeToursResponse
.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/cloud-platform