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

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، لا يتمّ ملء خطوط البوليجون إلا للمسارات غير الفارغة، ويتطلّب ذلك ضبط `populatePolylines` على "صحيح". قد تكون الحقول `routePolyline` للمسارات التي تم تمريرها غير متسقة مع المسار `transitions`. يجب عدم استخدام هذا الحقل مع `injectedFirstSolutionRoutes` أو `injectedSolutionConstraint`. لا يؤثّر الخياران `Shipment.ignore` و`Vehicle.ignore` في السلوك. لا تزال الخطوط المتعددة مليئة بين جميع الزيارات في جميع المسارات غير الفارغة بغض النظر عمّا إذا تم تجاهل الشحنات أو المركبات ذات الصلة.
`interpretInjectedSolutionsUsingLabels`	`boolean` إذا كانت القيمة هي true: تستخدم `ShipmentRoute.vehicle_label` بدلاً من `vehicleIndex` لمطابقة المسارات في حل تم حقنه مع المركبات في الطلب، وإعادة استخدام تعيين `ShipmentRoute.vehicle_index` الأصلي إلى `ShipmentRoute.vehicle_index` الجديد لتعديل `ConstraintRelaxation.vehicle_indices` إذا لم يكن فارغًا، ولكن يجب أن تكون عملية التعيين واضحة (أي يجب عدم مشاركة `ShipmentRoute`s متعددة في `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` (resp. `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` لاقتطاع عدد أخطاء التحقق من الصحة التي تم عرضها. عادةً ما ترتبط هذه الأخطاء بحمولة خطأ INSERT_SELECTED كتفاصيل خطأ BadRequest (https://cloud.google.com/apis/design/errors#error_details)، ما لم يكن العنوان SolutionMode=VALIDATE_ONLY: يُرجى الاطّلاع على الحقل `OptimizeToursResponse.validation_errors`. يكون هذا العدد التلقائي 100، والحد الأقصى له هو 10,000.

نص الاستجابة

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

نطاقات التفويض

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

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

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

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

routeoptimization.locations.use

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

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