تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Method: projects.optimizeTours

طلب HTTP
مَعلمات المسار
نص الطلب
- تمثيل JSON
نص الاستجابة
نطاقات التفويض
أذونات "إدارة الهوية وإمكانية الوصول"

لإرسال OptimizeToursRequest تحتوي على ShipmentModel وعرض OptimizeToursResponse تحتوي على ShipmentRoute، وهي مجموعة من المسارات التي يمكن للمركبات تنفيذها مع تقليل التكلفة الإجمالية.

يتكوّن نموذج ShipmentModel بشكلٍ أساسي من Shipment التي يجب تنفيذها وVehicles التي يمكن استخدامها لنقل Shipment. تُسنِد ShipmentRoute Shipment إلى Vehicle. على وجه التحديد، يتم تخصيص سلسلة من Visit لكل مركبة، حيث يتوافق Visit مع VisitRequest، وهو عملية استلام أو تسليم Shipment.

والهدف من ذلك هو توفير تخصيص ShipmentRoute إلى Vehicle، ما يقلّل من إجمالي التكلفة حيث تكون التكلفة محددة في ShipmentModel.

طلب HTTP

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

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

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

المعلمات

المعلمات
`parent`	`string` مطلوب. استهدِف المشروع أو الموقع الجغرافي لإجراء مكالمة. التنسيق: * `projects/{project-id}` * `projects/{project-id}/locations/{location-id}` في حال عدم تحديد أي موقع جغرافي، سيتم اختيار منطقة تلقائيًا.

parent

string

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

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

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

نص الطلب

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

تمثيل JSON

تمثيل 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,
  "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)` في حال ضبط هذه المهلة، يعرض الخادم استجابة قبل انقضاء فترة المهلة أو بلوغ الموعد النهائي للخادم للطلبات المتزامنة، أيهما أقرب. بالنسبة إلى الطلبات غير المتزامنة، سينشئ الخادم حلًا (إن أمكن) قبل انتهاء المهلة. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "`s`" مثال: `"3.5s"`
`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)` وإذا لم يكن الحقل فارغًا، سيتم تحديث المسارات بدون تعديل التسلسل الأساسي للزيارات أو مُدد السفر: سيتم تعديل التفاصيل الأخرى فقط. لا يؤدي ذلك إلى حلّ المشكلة في النموذج. اعتبارًا من 2020/2011، لن يؤدي ذلك إلا إلى تعبئة الخطوط المتعددة للمسارات غير الفارغة ويتطلب ضبط سياسة `populatePolylines`. قد تكون حقول `routePolyline` في المسارات التي تم تمريرها غير متّسقة مع المسار `transitions`. يجب عدم استخدام هذا الحقل مع `injectedFirstSolutionRoutes` أو `injectedSolutionConstraint`. ولا يؤثر `Shipment.ignore` و`Vehicle.ignore` في هذا السلوك. لا تزال الخطوط المتعددة مليئة بين جميع الزيارات في جميع المسارات غير الفارغة بغض النظر عمّا إذا تم تجاهل الشحنات أو المركبات ذات الصلة.
`interpretInjectedSolutionsUsingLabels`	`boolean` إذا كان صحيحًا: استخدام `ShipmentRoute.vehicle_label` بدلاً من `vehicleIndex` لمطابقة المسارات في الحل الذي تم حقنه مع المركبات في الطلب إعادة استخدام ربط `ShipmentRoute.vehicle_index` الأصلي بـ `ShipmentRoute.vehicle_index` الجديد لتعديل `ConstraintRelaxation.vehicle_indices` إذا لم يكن فارغًا، ولكن يجب أن تكون عملية الربط واضحة (أي يجب ألا تتشارك `ShipmentRoute` عدة عناصر `vehicleIndex` الأصلية نفسها). استخدام `ShipmentRoute.Visit.shipment_label` بدلاً من `shipmentIndex` لمطابقة الزيارات في الحل الذي تم حقنه مع الشحنات الواردة في الطلب يستخدم `SkippedShipment.label` بدلاً من `SkippedShipment.index` لمطابقة الشحنات التي تم تخطّيها في الحلّ الذي تمّ إدراجه مع الشحنات المطلوبة. ينطبق هذا التفسير على الحقول `injectedFirstSolutionRoutes` و`injectedSolutionConstraint` و`refreshDetailsRoutes`. ويمكن استخدامه عندما تتغير مؤشرات الشحن أو المركبات في الطلب منذ إنشاء الحل، ربما بسبب إزالة الشحنات أو المركبات من الطلب أو إضافتها إليه. إذا كانت القيمة هي true، يجب أن تظهر التصنيفات في الفئات التالية مرة واحدة كحدّ أقصى في فئتها: `Vehicle.label` في الطلب `Shipment.label` في الطلب `ShipmentRoute.vehicle_label` في المحلول الذي تم حقنه `SkippedShipment.label` و`ShipmentRoute.Visit.shipment_label` في الحلّ الذي تمّ إدراجه (باستثناء أزواج زيارات الاستلام/التسليم، التي يجب أن يظهر فيها `shipmentLabel` مرّتين). إذا لم يكن `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`s الاستجابة.
`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.

نص الاستجابة

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

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

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

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

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

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

routeoptimization.locations.use

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

Method: projects.optimizeTours تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.