Method: projects.optimizeToursLongRunning

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

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

طلب HTTP

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

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

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

المعلمات
parent

string

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

التنسيق:

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

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

نص الطلب

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

تمثيل JSON 
{
  "timeout": string,
  "model": {
    object (ShipmentModel)
  },
  "solvingMode": enum (SolvingMode),
  "searchMode": enum (SearchMode),
  "injectedFirstSolutionRoutes": [
    {
      object (ShipmentRoute)
    }
  ],
  "injectedSolutionConstraint": {
    object (InjectedSolutionConstraint)
  },
  "refreshDetailsRoutes": [
    {
      object (ShipmentRoute)
    }
  ],
  "interpretInjectedSolutionsUsingLabels": boolean,
  "considerRoadTraffic": boolean,
  "populatePolylines": boolean,
  "populateTransitionPolylines": boolean,
  "allowLargeDeadlineDespiteInterruptionRisk": boolean,
  "useGeodesicDistances": boolean,
  "label": string,
  "geodesicMetersPerSecond": number,
  "maxValidationErrors": integer
}
الحقول
timeout

string (Duration format)

في حال ضبط مهلة الاستجابة هذه، يعرض الخادم استجابة قبل انقضاء مدة المهلة أو قبل بلوغ الموعد النهائي الذي حدّده الخادم للطلبات المتزامنة، أيهما أقرب.

بالنسبة إلى الطلبات غير المتزامنة، سينشئ الخادم حلاً (إذا أمكن) قبل انقضاء المهلة.
model

object (ShipmentModel)

نموذج الشحن المطلوب حله
solvingMode

enum (SolvingMode)

يكون وضع الحلّ تلقائيًا DEFAULT_SOLVE (0).
searchMode

enum (SearchMode)

وضع البحث المستخدَم لحلّ الطلب
injectedFirstSolutionRoutes[]

object (ShipmentRoute)

توجيه خوارزمية التحسين للعثور على حلّ أوّلي مشابه لحلّ سابق

يتم تقييد النموذج عند إنشاء الحل الأول. يتم تخطّي أي شحنات لم يتم تنفيذها على مسار معيّن ضمنيًا في الحلّ الأول، ولكن يمكن تنفيذها في الحلول اللاحقة.

يجب أن يستوفي الحل بعض افتراضات الصلاحية الأساسية:

  • بالنسبة إلى جميع المسارات، يجب أن يكون vehicleIndex ضمن النطاق وألّا يكون مكررًا.
  • بالنسبة إلى جميع الزيارات، يجب أن يكون shipmentIndex وvisitRequestIndex ضمن النطاق.
  • لا يمكن الإشارة إلى شحنة إلا في مسار واحد.
  • يجب استلام شحنة الاستلام والتسليم قبل التسليم.
  • لا يمكن تنفيذ أكثر من بديل واحد للاستلام أو التوصيل لشحنة واحدة.
  • بالنسبة إلى جميع المسارات، تتزايد الأوقات (أي vehicleStartTime <= visits[0].start_time <= visits[1].start_time ... <= vehicleEndTime).
  • لا يمكن إجراء عملية شحن إلا على مركبة مسموح بها. يُسمح بالمركبة إذا كان Shipment.allowed_vehicle_indices فارغًا أو إذا كان vehicleIndex مضمّنًا في Shipment.allowed_vehicle_indices.

إذا لم يكن الحلّ الذي تم إدخاله ممكنًا، لن يتم بالضرورة عرض رسالة خطأ في التحقّق من الصحة، بل قد يتم عرض رسالة خطأ تشير إلى عدم إمكانية التنفيذ.
injectedSolutionConstraint

object (InjectedSolutionConstraint)

تقييد خوارزمية التحسين للعثور على حل نهائي مشابه لحل سابق على سبيل المثال، يمكن استخدام هذه السمة لتجميد أجزاء من المسارات التي تم إكمالها أو التي سيتم إكمالها ولكن يجب عدم تعديلها.

إذا لم يكن الحلّ الذي تم إدخاله ممكنًا، لن يتم بالضرورة عرض رسالة خطأ في التحقّق من الصحة، بل قد يتم عرض رسالة خطأ تشير إلى عدم إمكانية التنفيذ.
refreshDetailsRoutes[]

object (ShipmentRoute)

إذا لم يكن الحقل فارغًا، سيتم إعادة تحميل المسارات المحدّدة بدون تعديل تسلسل الزيارات أو أوقات السفر الأساسية، وسيتم تعديل التفاصيل الأخرى فقط. لا يحلّ هذا الإجراء المشكلة في النموذج.

اعتبارًا من 11/2020، لا يتم ملء خطوط متعدّدة الأضلاع إلا للمسارات غير الفارغة، ويجب أن تكون قيمة populatePolylines صحيحة.

قد تكون حقول routePolyline للمسارات التي تم تمريرها غير متوافقة مع المسار transitions.

يجب عدم استخدام هذا الحقل مع injectedFirstSolutionRoutes أو injectedSolutionConstraint.

ليس للقيمتَين Shipment.ignore وVehicle.ignore أي تأثير في السلوك. لا يزال يتم ملء الخطوط المتعددة بين جميع الزيارات في جميع الطرق غير الفارغة بغض النظر عمّا إذا كان يتم تجاهل الشحنات أو المركبات ذات الصلة.
interpretInjectedSolutionsUsingLabels

boolean

إذا كانت القيمة صحيحة:

ينطبق هذا التفسير على الحقول injectedFirstSolutionRoutes وinjectedSolutionConstraint وrefreshDetailsRoutes. يمكن استخدامها عندما تتغيّر مؤشرات الشحنات أو المركبات في الطلب منذ إنشاء الحلّ، ربما بسبب إزالة شحنات أو مركبات من الطلب أو إضافتها إليه.

إذا كانت القيمة هي true، يجب ألا تظهر التصنيفات في الفئات التالية أكثر من مرة في فئتها:

إذا لم يتطابق vehicleLabel في الحلّ الذي تم إدخاله مع مركبة مطلوبة، تتم إزالة المسار المطابق من الحلّ مع محطاته. إذا لم يتطابق shipmentLabel في الحلّ الذي تمّ إدخاله مع شحنة طلب، ستتمّ إزالة الزيارة المطابقة من الحلّ. إذا لم يتطابق SkippedShipment.label في الحلّ الذي تم إدخاله مع شحنة الطلب، تتم إزالة SkippedShipment من الحلّ.

قد تؤثر إزالة زيارات مسار أو مسارات كاملة من حلّ تم إدخاله في القيود الضمنية، ما قد يؤدي إلى تغيير في الحلّ أو حدوث أخطاء في التحقّق من الصحة أو عدم إمكانية التنفيذ.

ملاحظة: على المتصل التأكّد من أنّ كل Vehicle.label (أو Shipment.label) يحدّد بشكل فريد كيان مركبة (أو شحنة) مستخدَم في الطلبَين ذَوي الصلة: الطلب السابق الذي أنتج OptimizeToursResponse المستخدَم في الحلّ المُدخَل والطلب الحالي الذي يتضمّن الحلّ المُدخَل. إنّ عمليات التحقّق من التفرد الموضّحة أعلاه غير كافية لضمان استيفاء هذا الشرط.
considerRoadTraffic

boolean

ضَع في اعتبارك تقدير عدد الزيارات عند حساب الحقول ShipmentRoute وTransition.travel_duration وVisit.start_time وvehicleEndTime، وعند ضبط الحقل ShipmentRoute.has_traffic_infeasibilities، وعند حساب الحقل OptimizeToursResponse.total_cost.
populatePolylines

boolean

في حال ضبطها على "صحيح"، سيتم ملء الخطوط المتعددة في الردود ShipmentRoute.
populateTransitionPolylines

boolean

في حال ضبطها على "صحيح"، سيتم ملء الخطوط المتعددة ورموز المسار المميزة في الرد ShipmentRoute.transitions.
allowLargeDeadlineDespiteInterruptionRisk

boolean

في حال ضبط هذا الخيار، يمكن أن يكون للطلب موعد نهائي (راجِع https://grpc.io/blog/deadlines) يصل إلى 60 دقيقة. وفي ما عدا ذلك، يكون الحد الأقصى للموعد النهائي 30 دقيقة فقط. يُرجى العِلم أنّ الطلبات التي تستغرق وقتًا طويلاً تكون أكثر عرضة للانقطاع (وإن كان احتمال حدوث ذلك ضئيلاً).
useGeodesicDistances

boolean

في حال ضبط القيمة على "صحيح"، سيتم احتساب مسافات التنقّل باستخدام المسافات الجيوديسية بدلاً من مسافات "خرائط Google"، وسيتم احتساب مُدد التنقّل باستخدام المسافات الجيوديسية مع سرعة يحدّدها geodesicMetersPerSecond.
label

string

تصنيف يمكن استخدامه لتحديد هذا الطلب، ويتم إرجاعه في OptimizeToursResponse.request_label.
geodesicMetersPerSecond

number

عندما تكون قيمة useGeodesicDistances صحيحة، يجب ضبط هذا الحقل وتحديد السرعة المستخدَمة لاحتساب أوقات التنقّل. يجب أن تكون قيمته 1.0 متر/ثانية على الأقل.
maxValidationErrors

integer

يتم اقتطاع عدد أخطاء التحقّق من الصحة التي يتم عرضها. عادةً ما تكون هذه الأخطاء مرفقة بحِزمة بيانات خطأ INVALID_ARGUMENT كتفاصيل خطأ BadRequest (https://cloud.google.com/apis/design/errors#error_details)، ما لم يكن solvingMode=VALIDATE_ONLY: راجِع الحقل OptimizeToursResponse.validation_errors. القيمة التلقائية هي 100 والحد الأقصى هو 10,000.

نص الاستجابة

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

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

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

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

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

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

  • routeoptimization.operations.create

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