Package google.maps.routeoptimization.v1

int32

عدد الشحنات التي تم إجراؤها يُرجى العِلم أنّ زوج الاستلام والتسليم يُحتسب مرّة واحدة فقط.

Duration

إجمالي مدة السفر لمسار أو حلّ

Duration

إجمالي مدة الانتظار لمسار أو حلّ

Duration

إجمالي مدة التأخير لمسار أو حلّ

Duration

إجمالي مدة الاستراحة لمسار أو حلّ

Duration

إجمالي مدة الزيارة لمسار أو حلّ

Duration

يجب أن تكون المدة الإجمالية مساوية لمجموع كل المدد المذكورة أعلاه. بالنسبة إلى المسارات، يتوافق أيضًا مع:

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

إجمالي مسافة السفر لمسار أو حلّ

map<string, VehicleLoad>

الحد الأقصى للحمولة التي تم تحقيقها على المسار بأكمله (أو الحل)، لكل كمية على هذا المسار (أو الحل)، ويتم احتسابها كحد أقصى على جميع Transition.vehicle_loads (أو ShipmentRoute.metrics.max_loads.

int32

عدد عمليات الشحن الإلزامية التي تم إجراؤها

تجريبي: قد يتغيّر سلوك هذا الحقل أو وجوده في المستقبل.

double

مجموع Shipment.penalty_cost الشحنات التي تم إجراؤها

تجريبي: قد يتغيّر سلوك هذا الحقل أو وجوده في المستقبل.

string

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

التنسيق:

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

لا تتوفّر قيم {location-id} على مستوى المنطقة.

AsyncModelConfig

الحقل مطلوب. معلومات الإدخال/الإخراج لكل نموذج شراء، مثل مسارات الملفات وتنسيقات البيانات

string

اختيارية: اسم النموذج الذي يحدّده المستخدم، ويمكن استخدامه كاسم بديل من قِبل المستخدمين لتتبُّع النماذج.

InputConfig

الحقل مطلوب. معلومات عن النموذج المُدخل

OutputConfig

الحقل مطلوب. معلومات الموقع الجغرافي المطلوب للإخراج

BreakRequest

تسلسل الفواصل اطّلِع على رسالة BreakRequest.

FrequencyConstraint

قد تنطبق عدة FrequencyConstraint. يجب أن تستوفيها جميعًا BreakRequests في BreakRule هذا. يمكنك الاطّلاع على FrequencyConstraint.

Timestamp

الحقل مطلوب. الحدّ الأدنى (شامل) لبداية الاستراحة

Timestamp

الحقل مطلوب. الحدّ الأقصى (شاملاً) لبداية الاستراحة

Duration

الحقل مطلوب. الحدّ الأدنى لمدة الفاصل الإعلاني يجب أن تكون القيمة موجبة.

Duration

الحقل مطلوب. الحدّ الأدنى لمدة الاستراحة لهذا القيد يجب أن تكون القيمة غير سالبة. اطّلِع على وصف FrequencyConstraint.

Duration

الحقل مطلوب. الحد الأقصى المسموح به لأي فاصل زمني في المسار لا يتضمّن استراحة لمدة duration >= min_break_duration على الأقل جزئيًا. يجب أن تكون القيمة موجبة.

int64

حدّ صارم يفرض أن تكون المسافة بحدّ أقصى max_meters. يجب أن يكون الحدّ الأقصى غير سالب.

int64

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

إذا تم تحديد soft_max_meters، يجب أن تكون قيمتها أقل من max_meters وغير سالبة.

double

التكلفة لكل كيلومتر، وتزداد حتى soft_max_meters، بالصيغة التالية:

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

هذه التكلفة غير متاحة في route_distance_limit.

double

التكلفة لكل كيلومتر في حال تجاوزت المسافة الحدّ الأقصى البالغ soft_max_meters. تكون التكلفة الإضافية 0 إذا كانت المسافة أقل من الحدّ الأقصى، وإلا فإنّ الصيغة المستخدَمة لحساب التكلفة هي التالية:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

يجب أن تكون التكلفة غير سالبة.

string

الحقل مطلوب. معرّف الموارد المنتظم (URI) لخدمة Google Cloud Storage

string

الحقل مطلوب. معرّف الموارد المنتظم (URI) لعنصر Google Cloud Storage بالتنسيق gs://bucket/path/to/object.

ShipmentRoute

مسارات الحلول التي سيتم حقنها قد يتم حذف بعض المسارات من الحلّ الأصلي. يجب أن تستوفي المسارات والشحنات التي تم تخطّيها افتراضات الصلاحية الأساسية المدرَجة في injected_first_solution_routes.

SkippedShipment

الشحنات التي تم تخطّيها من الحلّ المطلوب إدخاله قد يتم حذف بعضها من الحل الأصلي. يُرجى الاطّلاع على حقل routes.

ConstraintRelaxation

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

Relaxation

جميع عمليات تخفيف قيود الزيارات التي سيتم تطبيقها على الزيارات في المسارات التي تتضمّن مركبات في vehicle_indices.

int32

تحدّد هذه السمة فهارس المركبات التي ينطبق عليها قيد الزيارة relaxations. إذا كان الحقل فارغًا، سيتم اعتبار ذلك الإعداد التلقائي وسيتم تطبيق relaxations على جميع المركبات غير المحدّدة في constraint_relaxations الأخرى. يمكن أن يكون هناك قيد تلقائي واحد على الأكثر، أي يُسمح بترك حقل واحد على الأكثر من حقول تخفيف القيود فارغًا vehicle_indices. يمكن إدراج فهرس مركبة مرة واحدة فقط، حتى ضمن عدة constraint_relaxations.

يتم ربط فهرس المركبة بالطريقة نفسها التي يتم بها ربط ShipmentRoute.vehicle_index، إذا كانت قيمة interpret_injected_solutions_using_labels صحيحة (يُرجى الاطّلاع على تعليق fields).

Level

مستوى تخفيف القيود الذي ينطبق عند استيفاء الشروط في threshold_time أو بعده وthreshold_visit_count على الأقل.

Timestamp

الوقت الذي يمكن فيه تطبيق الاسترخاء level أو بعده.

int32

عدد الزيارات التي يمكن تطبيق الاسترخاء level عندها أو بعدها. إذا كانت قيمة threshold_visit_count تساوي 0 (أو لم يتم ضبطها)، قد يتم تطبيق level مباشرةً عند بدء تشغيل المركبة.

إذا كانت القيمة route.visits_size() + 1، قد يتم تطبيق السمة level على الجزء الخلفي من المركبة فقط. إذا كانت المدة أطول من route.visits_size() + 1، لن يتم تطبيق level على هذا المسار على الإطلاق.

DataFormat

الحقل مطلوب. تنسيق بيانات الإدخال

GcsSource

موقع Google Cloud Storage يجب أن يكون هذا كائنًا واحدًا (ملفًا).

LatLng

الإحداثيات الجغرافية للنقطة على المسار

int32

تمثّل هذه السمة اتجاه البوصلة المرتبط باتجاه تدفق حركة المرور. تُستخدَم هذه القيمة لتحديد جانب الطريق الذي يجب استخدامه للركوب والنزول. يمكن أن تتراوح قيم الاتجاه من 0 إلى 360، حيث يشير الرقم 0 إلى اتجاه الشمال، ويشير الرقم 90 إلى اتجاه الشرق، وما إلى ذلك.

string

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

التنسيق:

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

لا تتوفّر قيم {location-id} على مستوى المنطقة.

Duration

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

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

ShipmentModel

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

SolvingMode

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

SearchMode

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

ShipmentRoute

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

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

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

• بالنسبة إلى جميع المسارات، يجب أن يكون vehicle_index ضمن النطاق وألا يكون مكررًا.
• بالنسبة إلى جميع الزيارات، يجب أن يكون shipment_index وvisit_request_index ضمن النطاق.
• يمكن الإشارة إلى شحنة واحدة فقط في مسار واحد.
• يجب استلام شحنة الاستلام والتسليم قبل التسليم.
• لا يجوز تنفيذ أكثر من بديل واحد للاستلام أو بديل واحد للتسليم لشحنة معيّنة.
• بالنسبة إلى جميع المسارات، تزداد الأوقات (أي vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• لا يمكن تنفيذ الشحنة إلا على مركبة مسموح بها. يُسمح بمركبة إذا كان الحقل Shipment.allowed_vehicle_indices فارغًا أو إذا كان الحقل vehicle_index مضمّنًا في الحقل Shipment.allowed_vehicle_indices.

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

InjectedSolutionConstraint

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

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

ShipmentRoute

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

اعتبارًا من نوفمبر 2020، لا يؤدي هذا إلا إلى تعبئة الخطوط المتعدّدة للمسارات غير الفارغة ويتطلّب ضبط populate_polylines على "صحيح".

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

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

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

bool

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

• يستخدم ShipmentRoute.vehicle_label بدلاً من vehicle_index لمطابقة المسارات في حلّ تم إدخاله مع المركبات في الطلب، ويعيد استخدام عملية ربط ShipmentRoute.vehicle_index الأصلي بـ ShipmentRoute.vehicle_index الجديد لتعديل ConstraintRelaxation.vehicle_indices إذا لم يكن فارغًا، ولكن يجب أن تكون عملية الربط واضحة (أي يجب ألا تتشارك عدة ShipmentRoute في vehicle_index الأصلي نفسه).
• يستخدم ShipmentRoute.Visit.shipment_label بدلاً من shipment_index لمطابقة الزيارات في الحلّ المُدخَل مع الشحنات في الطلب.
• يستخدم SkippedShipment.label بدلاً من SkippedShipment.index لمطابقة الشحنات التي تم تخطّيها في الحلّ المُدخَل مع الشحنات المطلوبة.

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

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

• ‫Vehicle.label في الطلب
• ‫Shipment.label في الطلب
• ‫ShipmentRoute.vehicle_label في المحلول المحقون
• ‫SkippedShipment.label وShipmentRoute.Visit.shipment_label في الحلّ الذي تم إدخاله (باستثناء أزواج زيارات الاستلام/التسليم التي يجب أن يظهر فيها shipment_label مرتين).

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

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

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

bool

يُرجى مراعاة تقدير عدد الزيارات عند احتساب حقول ShipmentRoute Transition.travel_duration وVisit.start_time وvehicle_end_time، وعند ضبط حقل ShipmentRoute.has_traffic_infeasibilities، وعند احتساب حقل OptimizeToursResponse.total_cost.

bool

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

bool

إذا كانت القيمة "صحيح"، سيتم ملء الخطوط المتعدّدة ورموز المسارات في الردّ ShipmentRoute.transitions.

bool

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

bool

إذا كانت القيمة صحيحة، سيتم احتساب مسافات السفر باستخدام المسافات الجيوديسية بدلاً من مسافات "خرائط Google"، وسيتم احتساب مُدد الرحلات باستخدام المسافات الجيوديسية مع سرعة يحدّدها الحقل geodesic_meters_per_second.

string

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

double

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

int32

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

ShipmentRoute

المسارات المحسوبة لكل مركبة، حيث يتوافق المسار i مع المركبة i في النموذج.

string

نسخة من OptimizeToursRequest.label، إذا تم تحديد تصنيف في الطلب

SkippedShipment

قائمة بجميع الشحنات التي تم تخطّيها

OptimizeToursValidationError

قائمة بجميع أخطاء التحقّق التي تمكّنا من رصدها بشكل مستقل يُرجى الاطّلاع على شرح "أخطاء متعددة" لرسالة OptimizeToursValidationError. بدلاً من الأخطاء، سيتضمّن ذلك تحذيرات في حال كانت قيمة solving_mode هي DEFAULT_SOLVE.

OptimizeToursRequest

في بعض الحالات، نعدّل الطلب الوارد قبل حلّه، أي نضيف التكاليف. إذا كانت قيمة solving_mode تساوي TRANSFORM_AND_RETURN_REQUEST، يتم عرض الطلب المعدَّل هنا.

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request لمزيد من التفاصيل.

Metrics

مقاييس المدة والمسافة والاستخدام لهذا الحلّ

AggregatedMetrics

يتم تجميعها على مستوى المسارات. كل مقياس هو مجموع (أو الحد الأقصى، لعمليات التحميل) لجميع حقول ShipmentRoute.metrics التي تحمل الاسم نفسه.

int32

عدد الشحنات الإلزامية التي تم تخطّيها

int32

عدد المركبات المستخدَمة ملاحظة: إذا كان مسار المركبة فارغًا وكانت قيمة Vehicle.used_if_route_is_empty صحيحة، يتم اعتبار المركبة مستخدَمة.

Timestamp

أقرب وقت بدء لمركبة مستخدَمة، ويتم احتسابه كأدنى قيمة لجميع المركبات المستخدَمة في ShipmentRoute.vehicle_start_time.

Timestamp

آخر وقت انتهاء لمركبة مستخدَمة، ويتم احتسابه كحد أقصى لجميع المركبات المستخدَمة في ShipmentRoute.vehicle_end_time.

map<string, double>

تكلفة الحلّ، مقسّمة حسب حقول الطلبات ذات الصلة بالتكلفة المفاتيح هي مسارات أولية، نسبةً إلى طلب OptimizeToursRequest المُدخل، مثل "model.shipments.pickups.cost"، والقيم هي إجمالي التكلفة التي تم إنشاؤها بواسطة حقل التكلفة المقابل، ويتم تجميعها على مستوى الحلّ بالكامل. بمعنى آخر، costs["model.shipments.pickups.cost"] هو مجموع كل تكاليف الاستلام في الحلّ. يتم هنا عرض تفاصيل جميع التكاليف المحدّدة في النموذج، باستثناء التكاليف المرتبطة بسمات TransitionAttributes التي يتم عرضها بشكل مجمّع فقط اعتبارًا من يناير 2022.

double

التكلفة الإجمالية للحلّ مجموع كل القيم في خريطة التكاليف.

string

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

التنسيق:

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

لا تتوفّر قيم {location-id} على مستوى المنطقة.

Uri

الحقل مطلوب. معرّف الموارد المنتظم (URI) لعنصر Cloud Storage الذي يحتوي على OptimizeToursRequest.

Uri

الحقل مطلوب. معرّف الموارد المنتظم (URI) لعنصر Cloud Storage الذي سيحتوي على OptimizeToursResponse.

Uri

اختيارية: معرّف الموارد المنتظم (URI) لعنصر Cloud Storage الذي يحتوي على OptimizeToursResponse بترميز JSON أو textproto إذا تم ترميز العنصر بتنسيق JSON، سيكون امتداد اسم العنصر .json. إذا تم ترميز الكائن كـ textproto، سيكون امتداد اسم الكائن هو .txtpb.

يمكن استخدام crc32_checksum المورد للتحقّق من عدم تعديل محتواه.

int32

يتم تحديد خطأ التحقّق من خلال الزوج (code, display_name) الذي يكون متوفّرًا دائمًا.

توفّر الحقول التي تلي هذا القسم مزيدًا من السياق حول الخطأ.

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

الثبات: يجب أن يكون كل من code وdisplay_name ثابتًا للغاية. ولكن قد تظهر رموز وأسماء معروضة جديدة بمرور الوقت، ما قد يؤدي إلى ظهور زوج مختلف (code، display_name) لطلب معيّن (غير صالح) لأنّ الخطأ الجديد أخفى الخطأ القديم. على سبيل المثال، راجِع "أخطاء متعددة".

string

الاسم المعروض للخطأ

FieldReference

قد يتضمّن سياق الخطأ صفرًا أو حقلًا واحدًا (في معظم الأحيان) أو أكثر. على سبيل المثال، يمكن الإشارة إلى المركبة رقم 4 وأول عملية استلام للشحنة رقم 2 على النحو التالي:

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 sub_field {name: "pickups" index: 0} }

يُرجى العِلم أنّه يجب عدم تغيير عدد القيم الفريدة للسمة fields لرمز خطأ معيّن.

string

سلسلة يمكن لشخص عادي قراءتها تصف الخطأ هناك ربط بين code وerror_message (عندما يكون الرمز != "UNSPECIFIED").

الثبات: غير ثابتة، فقد تتغيّر رسالة الخطأ المرتبطة بـ code معيّن (على أمل توضيحها) بمرور الوقت. يُرجى الاعتماد على display_name وcode بدلاً من ذلك.

string

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

string

اسم الحقل، مثل "vehicles".

FieldReference

حقل فرعي متداخل بشكل متكرر، إذا لزم الأمر.

int32

فهرس الحقل إذا كان متكررًا

string

المفتاح إذا كان الحقل خريطة

DataFormat

الحقل مطلوب. تنسيق بيانات الناتج

GcsDestination

موقع Google Cloud Storage الذي ستتم كتابة الناتج فيه

bool

تحدّد هذه السياسة ما إذا كان يجب تجنّب الطرق برسوم عبور حيثما أمكن. ستُعطى الأولوية للمسارات التي لا تحتوي على طرق برسوم عبور. ينطبق ذلك على وسائل النقل الآلية فقط.

bool

تحدّد ما إذا كان يجب تجنّب الطرق السريعة حيثما أمكن. سيتم إعطاء الأولوية للمسارات التي لا تحتوي على طرق سريعة. ينطبق ذلك على وسائل النقل الآلية فقط.

bool

تحدّد ما إذا كان يجب تجنُّب العبّارات حيثما أمكن. سيتم إعطاء الأولوية للمسارات التي لا تتضمّن السفر بالعبّارات. ينطبق ذلك على وسائل النقل الآلية فقط.

bool

اختيارية: تحدّد ما إذا كان يجب تجنُّب التنقّل داخل المباني حيثما كان ذلك معقولاً. ستُعطى الأولوية للمسارات التي لا تحتوي على ميزة التنقّل داخل المباني. ينطبق ذلك على وضع السفر "WALKING" فقط.

string

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

VisitRequest

مجموعة من بدائل الاستلام المرتبطة بالشحنة في حال عدم تحديدها، يجب أن تزور المركبة فقط الموقع الجغرافي المقابل لعمليات التسليم.

VisitRequest

مجموعة من بدائل التسليم المرتبطة بالشحنة في حال عدم تحديدها، يجب أن تزور المركبة فقط موقعًا جغرافيًا يتوافق مع عمليات الاستلام.

map<string, Load>

متطلبات حمولة الشحنة (مثل الوزن والحجم وعدد المنصات النقالة وما إلى ذلك) يجب أن تكون المفاتيح في الخريطة معرّفات تصف نوع الحمولة المقابلة، ومن الأفضل أن تتضمّن أيضًا الوحدات. على سبيل المثال: "weight_kg" و"volume_gallons" و"pallet_count" وما إلى ذلك. إذا لم يظهر مفتاح معيّن في الخريطة، يتم اعتبار الحمولة المقابلة فارغة.

int32

مجموعة المركبات التي قد تنفّذ عملية الشحن هذه إذا كان هذا الحقل فارغًا، يمكن لجميع المركبات تنفيذ المهمة. يتم تحديد المركبات من خلال فهرسها في قائمة vehicles الخاصة بـ ShipmentModel.

double

يحدّد التكلفة التي يتم تحمّلها عند تسليم هذه الشحنة بواسطة كل مركبة. في حال تحديدها، يجب أن تتضمّن أيًا مما يلي:

• نفس عدد العناصر مثل costs_per_vehicle_indices. تمثّل السمة costs_per_vehicle[i] المركبة costs_per_vehicle_indices[i] في النموذج.
• نفس عدد العناصر الموجودة في المركبات في النموذج. يتجاوب العنصر i مع المركبة رقم i في النموذج.

يجب أن تكون هذه التكاليف بالوحدة نفسها المستخدَمة في penalty_cost ويجب ألا تكون سالبة. اترك هذا الحقل فارغًا في حال عدم توفّر هذه التكاليف.

int32

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

Duration

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

على سبيل المثال، لنفترض أنّ t هو أقصر وقت يستغرقه الانتقال من بديل الاستلام المحدّد مباشرةً إلى بديل التسليم المحدّد. بعد ذلك، يفرض الإعداد pickup_to_delivery_absolute_detour_limit ما يلي:

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

إذا تم تحديد كل من الحدود النسبية والمطلقة في الشحنة نفسها، يتم استخدام الحد الأكثر تقييدًا لكل زوج ممكن من عمليات الاستلام/التسليم. اعتبارًا من تشرين الأول (أكتوبر) 2017، لا يُسمح بالانحرافات إلا عندما لا تعتمد مدة السفر على المركبات.

Duration

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

string

سلسلة غير فارغة تحدّد "نوع" هذه الشحنة. يمكن استخدام هذه الميزة لتحديد حالات عدم التوافق أو المتطلبات بين shipment_types (راجِع shipment_type_incompatibilities وshipment_type_requirements في ShipmentModel).

تختلف هذه السمة عن visit_types التي يتم تحديدها لزيارة واحدة: تتشارك جميع عمليات الاستلام/التسليم التي تنتمي إلى الشحنة نفسها السمة shipment_type نفسها.

string

تحدّد هذه السمة تصنيفًا لهذه الشحنة. يتم عرض هذا التصنيف في الردّ في الحقل shipment_label من السمة ShipmentRoute.Visit المقابلة.

bool

إذا كانت القيمة "صحيح"، يتم تخطّي هذه الشحنة، ولكن لا يتم تطبيق penalty_cost.

يؤدي تجاهل شحنة إلى حدوث خطأ في عملية التحقّق في حال توفّر أي shipment_type_requirements في النموذج.

يُسمح بتجاهل شحنة يتم تنفيذها في injected_first_solution_routes أو injected_solution_constraint، ويزيل الحلّال زيارات الاستلام/التسليم ذات الصلة من المسار الذي يتم تنفيذه. وسيتم أيضًا تجاهل precedence_rules التي تشير إلى الشحنات التي تم تجاهلها.

double

إذا لم تكتمل الشحنة، تتم إضافة هذه الغرامة إلى التكلفة الإجمالية للمسارات. تُعتبر الشحنة مكتملة إذا تمت زيارة أحد بدائل الاستلام والتسليم. يمكن التعبير عن التكلفة بالوحدة نفسها المستخدَمة لجميع الحقول الأخرى ذات الصلة بالتكلفة في النموذج، ويجب أن تكون موجبة.

ملاحظة مهمة: إذا لم يتم تحديد هذه الغرامة، تُعتبر غير محدودة، أي يجب إكمال الشحنة.

double

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

على سبيل المثال، لنفترض أنّ t هو أقصر وقت يستغرقه الانتقال من بديل الاستلام المحدّد مباشرةً إلى بديل التسليم المحدّد. بعد ذلك، يفرض الإعداد pickup_to_delivery_relative_detour_limit ما يلي:

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

إذا تم تحديد كل من الحدود النسبية والمطلقة في الشحنة نفسها، يتم استخدام الحد الأكثر تقييدًا لكل زوج ممكن من عمليات الاستلام/التسليم. اعتبارًا من تشرين الأول (أكتوبر) 2017، لا يُسمح بالانحرافات إلا عندما لا تعتمد مدة السفر على المركبات.

int64

المقدار الذي ستختلف به حمولة المركبة التي تنفّذ الزيارة المقابلة. بما أنّها قيمة عددية صحيحة، ننصح المستخدمين باختيار وحدة مناسبة لتجنُّب فقدان الدقة. يجب أن تكون القيمة أكبر من أو تساوي 0.

LatLng

الموقع الجغرافي الذي تصل إليه المركبة عند تنفيذ VisitRequest. إذا كان نموذج الشحنة يحتوي على مصفوفات مسافة المدة، يجب عدم تحديد arrival_location.

Waypoint

النقطة على المسار التي تصل إليها المركبة عند تنفيذ VisitRequest هذا. إذا كان نموذج الشحنة يحتوي على مصفوفات مسافة المدة، يجب عدم تحديد arrival_waypoint.

LatLng

الموقع الجغرافي الذي تغادر منه المركبة بعد إكمال VisitRequest. يمكن حذفها إذا كانت مماثلة لسمة arrival_location. إذا كان نموذج الشحنة يحتوي على مصفوفات مسافة المدة، يجب عدم تحديد departure_location.

Waypoint

النقطة على المسار التي تغادر منها المركبة بعد إكمال هذه VisitRequest. يمكن حذفها إذا كانت مماثلة لسمة arrival_waypoint. إذا كان نموذج الشحنة يحتوي على مصفوفات مسافة المدة، يجب عدم تحديد departure_waypoint.

string

تحدّد هذه المَعلمة العلامات المرفقة بطلب الزيارة. لا يُسمح بالسلاسل الفارغة أو المكرّرة.

TimeWindow

النوافذ الزمنية التي تقيّد وقت الوصول إلى الزيارة يُرجى العِلم أنّ المركبة قد تغادر خارج الإطار الزمني للوصول، أي أنّ وقت الوصول والمدة لا يلزم أن يكونا ضمن إطار زمني. قد يؤدي ذلك إلى الانتظار إذا وصلت المركبة قبل TimeWindow.start_time.

ويعني عدم توفّر TimeWindow أنّ المركبة يمكنها إجراء هذه الزيارة في أي وقت.

يجب أن تكون النوافذ الزمنية منفصلة، أي يجب ألا تتداخل أي نافذة زمنية مع نافذة أخرى أو تكون مجاورة لها، ويجب أن تكون بترتيب تصاعدي.

لا يمكن ضبط cost_per_hour_after_soft_end_time وsoft_end_time إلا إذا كانت هناك نافذة زمنية واحدة.

Duration

مدة الزيارة، أي الوقت الذي تقضيه المركبة بين الوصول والمغادرة (تتم إضافته إلى وقت الانتظار المحتمل، راجِع time_windows).

double

تكلفة خدمة طلب الزيارة هذا على مسار مركبة يمكن استخدام هذه السمة لدفع تكاليف مختلفة لكل عملية استلام أو تسليم بديلة لشحنة. يجب أن تكون هذه التكلفة بالوحدة نفسها المستخدَمة في Shipment.penalty_cost وألّا تكون سالبة.

map<string, Load>

تحميل متطلبات طلب الزيارة هذا يشبه هذا الحقل حقل Shipment.load_demands، إلا أنّه ينطبق فقط على VisitRequest هذه بدلاً من Shipment بالكامل. تتم إضافة الطلبات المدرَجة هنا إلى الطلبات المدرَجة في Shipment.load_demands.

string

تحدّد أنواع الزيارة. ويمكن استخدام هذه السمة لتخصيص وقت إضافي مطلوب لمركبة لإكمال هذه الزيارة (راجِع Vehicle.extra_visit_duration_for_visit_type).

يمكن أن يظهر النوع مرة واحدة فقط.

string

تحدّد هذه السمة تصنيفًا لـ VisitRequest. يتم الإبلاغ عن هذا التصنيف في الردّ على أنّه visit_label في ShipmentRoute.Visit المقابل.

bool

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

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request لمزيد من التفاصيل.

Shipment

مجموعة من الشحنات التي يجب تنفيذها في النموذج

Vehicle

مجموعة من المركبات التي يمكن استخدامها لإجراء الزيارات

Objective

مجموعة الأهداف لهذا النموذج، والتي سنحوّلها إلى تكاليف. إذا لم يكن النموذج فارغًا، يجب أن يكون نموذج الإدخال مجانيًا. للحصول على الطلب المعدَّل، يُرجى استخدام solving_mode = TRANSFORM_AND_RETURN_REQUEST. يُرجى العِلم أنّه لن يتم حلّ الطلب في هذه الحالة. يُرجى الاطّلاع على المستندات ذات الصلة.

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request لمزيد من التفاصيل.

Timestamp

وقت البدء والانتهاء العام للنموذج: لا يمكن اعتبار أي أوقات خارج هذا النطاق صالحة.

يجب أن يكون النطاق الزمني للنموذج أقل من عام، أي أنّه يجب أن يكون الفارق بين global_end_time وglobal_start_time أقل من 31,536,000 ثانية.

عند استخدام حقول cost_per_*hour، قد تحتاج إلى ضبط هذه النافذة على فترة زمنية أصغر لزيادة الأداء (على سبيل المثال، إذا كنت تنشئ نموذجًا ليوم واحد، يجب ضبط الحدود الزمنية العامة على ذلك اليوم). في حال عدم ضبط هذه القيمة، يتم استخدام 00:00:00 بالتوقيت العالمي المنسق، 1 يناير 1970 (أي الثواني: 0، النانو ثانية: 0) كقيمة تلقائية.

Timestamp

في حال عدم ضبطها، يتم استخدام 00:00:00 بالتوقيت العالمي المنسق، 1 يناير 1971 (أي الثواني: 31536000، النانو ثانية: 0) كقيمة تلقائية.

double

"المدة الإجمالية" للخطة العامة هي الفرق بين أقرب وقت بدء فعلي وآخر وقت انتهاء فعلي لجميع المركبات. ويمكن للمستخدمين تحديد تكلفة لكل ساعة لتلك الكمية من أجل محاولة تحسين إكمال المهمة في أقرب وقت، على سبيل المثال. يجب أن تكون هذه التكلفة بالوحدة نفسها المستخدَمة في Shipment.penalty_cost.

DurationDistanceMatrix

تحدّد مصفوفات المدة والمسافة المستخدَمة في النموذج. إذا كان هذا الحقل فارغًا، سيتم استخدام "خرائط Google" أو المسافات الجيوديسية بدلاً من ذلك، استنادًا إلى قيمة الحقل use_geodesic_distances. إذا لم يكن فارغًا، لا يمكن أن يكون use_geodesic_distances صحيحًا ولا يمكن أن يكون duration_distance_matrix_src_tags أو duration_distance_matrix_dst_tags فارغًا.

أمثلة على الاستخدام:

• هناك موقعان جغرافيان: الموقع الجغرافي (أ) والموقع الجغرافي (ب).
• مركبة واحدة تبدأ مسارها في locA وتنتهي في locA.
• طلب زيارة واحد لاستلام الطرود في الموقع B

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• هناك ثلاثة مواقع جغرافية: الموقع "أ" والموقع "ب" والموقع "ج".
• مركبة واحدة تبدأ مسارها في locA وتنتهي في locB، باستخدام المصفوفة "fast".
• مركبة واحدة تبدأ مسارها في locB وتنتهي في locB، باستخدام المصفوفة "slow".
• مركبة واحدة تبدأ مسارها من الموقع B وتنتهي في الموقع B، باستخدام مصفوفة "سريعة".
• طلب زيارة واحد لاستلام الطلب في الموقع الجغرافي C

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

علامات تحدّد مصادر مصفوفات المدة والمسافة، حيث تحدّد duration_distance_matrices(i).rows(j) المدد والمسافات من الزيارات التي تحمل العلامة duration_distance_matrix_src_tags(j) إلى الزيارات الأخرى في المصفوفة i.

تتوافق العلامات مع VisitRequest.tags أو Vehicle.start_tags. يجب أن يتطابق VisitRequest أو Vehicle معيّن مع علامة واحدة بالضبط في هذا الحقل. يُرجى العِلم أنّ علامات المصدر والوجهة والمصفوفة في Vehicle قد تكون متطابقة، وبالمثل قد تكون علامات المصدر والوجهة في VisitRequest متطابقة. يجب أن تكون جميع العلامات مختلفة ولا يمكن أن تكون سلاسل فارغة. إذا لم يكن هذا الحقل فارغًا، يجب ألا يكون الحقل duration_distance_matrices فارغًا.

string

علامات تحدّد وجهات مصفوفات المدة والمسافة، duration_distance_matrices(i).rows(j).durations(k) (أو يحدّد duration_distance_matrices(i).rows(j).meters(k)) مدة (أو مسافة) السفر من الزيارات التي تحمل العلامة duration_distance_matrix_src_tags(j) إلى الزيارات التي تحمل العلامة duration_distance_matrix_dst_tags(k) في المصفوفة i.

تتوافق العلامات مع VisitRequest.tags أو Vehicle.start_tags. يجب أن يتطابق VisitRequest أو Vehicle معيّن مع علامة واحدة بالضبط في هذا الحقل. يُرجى العِلم أنّ علامات المصدر والوجهة والمصفوفة في Vehicle قد تكون متطابقة، وبالمثل قد تكون علامات المصدر والوجهة في VisitRequest متطابقة. يجب أن تكون جميع العلامات مختلفة ولا يمكن أن تكون سلاسل فارغة. إذا لم يكن هذا الحقل فارغًا، يجب ألا يكون الحقل duration_distance_matrices فارغًا.

TransitionAttributes

تمت إضافة سمات الانتقال إلى النموذج.

ShipmentTypeIncompatibility

مجموعات من shipment_types غير المتوافقة (يُرجى الاطّلاع على ShipmentTypeIncompatibility).

ShipmentTypeRequirement

مجموعات من متطلبات shipment_type (يُرجى الاطّلاع على ShipmentTypeRequirement).

PrecedenceRule

مجموعة من قواعد الأولوية التي يجب فرضها في النموذج

ملاحظة مهمة: يؤدي استخدام قواعد الأولوية إلى الحدّ من حجم المشكلة التي يمكن تحسينها. قد يتم رفض الطلبات التي تستخدم قواعد الأولوية التي تتضمّن العديد من الشحنات.

int32

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

Row

تحدّد هذه السمة صفوف مصفوفة المدة والمسافة. يجب أن يحتوي على عدد عناصر يساوي ShipmentModel.duration_distance_matrix_src_tags.

string

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

يجب أن تتطابق كل نقطة انطلاق للمركبة مع مصفوفة واحدة بالضبط، أي يجب أن يتطابق حقل start_tags واحد بالضبط مع vehicle_start_tag لمصفوفة (وتلك المصفوفة فقط).

يجب أن يكون لكل مصفوفة قيمة مختلفة لسمة vehicle_start_tag.

Duration

قيم المدة لصف معيّن يجب أن يحتوي على عدد العناصر نفسه في ShipmentModel.duration_distance_matrix_dst_tags.

double

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

Type

نوع الهدف

double

مدى أهمية هذا الهدف مقارنةً بالأهداف الأخرى يمكن أن تكون هذه القيمة أي رقم غير سالب، ولا يجب أن يكون مجموع الأوزان 1. تكون القيم التلقائية للأوزان هي 1.0.

bool

تشير إلى ما إذا كان الحدث "الأول" هو عملية تسليم.

bool

يشير إلى ما إذا كان الحدث "الثاني" هو عملية تسليم.

Duration

تمثّل هذه السمة الإزاحة بين الحدث "الأول" و "الثاني". ويمكن أن تكون سلبية.

int32

فهرس الشحنة للحدث "الأول". يجب تحديد هذا الحقل.

int32

فهرس الشحنة للحدث "الثاني". يجب تحديد هذا الحقل.

int32

المركبة التي تسلك المسار، ويتم تحديدها من خلال فهرسها في المصدر ShipmentModel.

string

تصنيف المركبة التي تسلك هذا المسار، ويساوي ShipmentModel.vehicles(vehicle_index).label، في حال تحديده

Timestamp

الوقت الذي تبدأ فيه المركبة مسارها

Timestamp

الوقت الذي تنهي فيه المركبة مسارها

Visit

تسلسل مرتّب للزيارات يمثّل مسارًا. visits[i] هي الزيارة رقم i في المسار. إذا كان هذا الحقل فارغًا، يتم اعتبار المركبة غير مستخدَمة.

Transition

قائمة مع ترتيب بالانتقالات للمسار

bool

عند ضبط السمة OptimizeToursRequest.consider_road_traffic على القيمة "صحيح"، يشير هذا الحقل إلى أنّه يتم توقّع التناقضات في توقيت المسارات باستخدام تقديرات مدة الرحلة المستندة إلى حركة المرور. قد لا يكون هناك وقت كافٍ لإكمال الرحلات المعدَّلة حسب حركة المرور والتأخيرات والاستراحات بين الزيارات أو قبل الزيارة الأولى أو بعد الزيارة الأخيرة، مع استيفاء النوافذ الزمنية للزيارة والمركبة. على سبيل المثال:

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

من المرجّح أن يتم الوصول إلى next_visit في وقت متأخر عن الإطار الزمني الحالي بسبب زيادة تقدير مدة الرحلة travel_duration(previous_visit, next_visit) بسبب حركة المرور. بالإضافة إلى ذلك، قد يتم فرض تداخل فترة الاستراحة مع زيارة بسبب زيادة في تقديرات مدة الرحلة والقيود المفروضة على الإطار الزمني للزيارة أو الاستراحة.

EncodedPolyline

تمثيل الخطوط المتعددة المشفَّرة للمسار لا تتم تعبئة هذا الحقل إلا إذا تم ضبط OptimizeToursRequest.populate_polylines على "صحيح".

Break

تمثّل هذه السمة فترات الاستراحة المجدوَلة للمركبة التي تسلك هذا المسار. يمثّل التسلسل breaks فترات زمنية، تبدأ كل منها عند start_time المقابل وتستمر لمدة duration ثانية.

AggregatedMetrics

مقاييس المدة والمسافة والحمولة لهذا المسار يتم جمع حقول AggregatedMetrics في جميع ShipmentRoute.transitions أو ShipmentRoute.visits، حسب السياق.

VehicleFullness

حقل VehicleFullness لاحتساب مدى اقتراب المقاييس المحدودة من حدود المركبات الخاصة بها. حقولها هي نِسب بين حقل مقياس محدود (مثل AggregatedMetrics.travel_distance_meters) والحدّ الأقصى ذي الصلة للمركبات (مثل Vehicle.route_distance_limit).

تجريبي: قد يتغيّر سلوك هذا الحقل أو وجوده في المستقبل.

map<string, double>

تكلفة المسار، مقسّمة حسب حقول الطلبات ذات الصلة بالتكلفة المفاتيح هي مسارات بروتوكول، نسبةً إلى طلب OptimizeToursRequest المُدخل، مثل "model.shipments.pickups.cost"، والقيم هي إجمالي التكلفة التي تم إنشاؤها بواسطة حقل التكلفة المقابل، ويتم تجميعها على المسار بأكمله. بعبارة أخرى، costs["model.shipments.pickups.cost"] هو مجموع كل تكاليف الاستلام على المسار. يتم هنا عرض تفاصيل جميع التكاليف المحدّدة في النموذج، باستثناء التكاليف المرتبطة بسمات TransitionAttributes التي يتم عرضها بشكل مجمّع فقط اعتبارًا من يناير 2022.

double

إجمالي تكلفة المسار مجموع كل التكاليف في خريطة التكلفة.

Timestamp

وقت بدء الاستراحة

Duration

مدة الاستراحة

string

سلسلة تمثّل النقاط المرمّزة للخطوط المتعدّدة

Duration

مدة السفر خلال هذه الفترة الانتقالية

double

المسافة المقطوعة أثناء الانتقال

bool

عند طلب معلومات عن حركة المرور من خلال OptimizeToursRequest.consider_road_traffic، وتعذُّر استرداد هذه المعلومات لـ Transition، يتم ضبط هذه القيمة المنطقية على "صحيح". قد يكون هذا مؤقتًا (مشكلة نادرة في خوادم حركة المرور في الوقت الفعلي) أو دائمًا (لا توجد بيانات لهذا الموقع).

Duration

مجموع مُدد التأخير المطبَّقة على عملية النقل هذه يبدأ التأخير، إن وُجد، قبل delay_duration ثانية بالضبط من الحدث التالي (الزيارة أو نهاية مسار المركبة). يمكنك الاطّلاع على TransitionAttributes.delay.

Duration

مجموع مدة الفواصل التي تحدث أثناء هذا الانتقال، إن وُجدت يتم تخزين تفاصيل حول وقت بدء كل فاصل ومدته في ShipmentRoute.breaks.

Duration

الوقت المستغرَق في الانتظار أثناء هذا الانتقال تتوافق مدة الانتظار مع وقت عدم النشاط ولا تشمل وقت الاستراحة. يُرجى العِلم أيضًا أنّ وقت الانتظار هذا قد يتم تقسيمه إلى عدة فترات غير متجاورة.

Duration

إجمالي مدة الانتقال، ويتم توفيرها لتسهيل الأمر. وهي تساوي:

• الزيارة التالية start_time (أو vehicle_end_time إذا كانت هذه هي عملية الانتقال الأخيرة) - start_time لعملية الانتقال هذه
• إذا كانت قيمة ShipmentRoute.has_traffic_infeasibilities هي "خطأ"، ينطبق أيضًا ما يلي: total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

وقت بدء هذا الانتقال

EncodedPolyline

تمثيل الخطوط المتعددة المرمّزة للمسار الذي تم اتّباعه أثناء الانتقال لا تتم تعبئة هذا الحقل إلا إذا تم ضبط populate_transition_polylines على "صحيح".

string

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

map<string, VehicleLoad>

حمولة المركبة أثناء هذا الانتقال، لكل نوع يظهر في Vehicle.load_limits لهذه المركبة، أو يحتوي على Shipment.load_demands غير صفري في بعض الشحنات التي يتم إجراؤها على هذا المسار.

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

int64

مقدار الحمولة على المركبة، حسب النوع المحدّد عادةً ما تتم الإشارة إلى وحدة الحمل حسب النوع. يمكنك الاطّلاع على Transition.vehicle_loads.

int32

فهرس الحقل "shipments" في المصدر "ShipmentModel".

bool

إذا كانت القيمة "صحيح"، تتوافق الزيارة مع استلام Shipment. وإلّا، فإنّها تتوافق مع عملية تسليم.

int32

فهرس VisitRequest في حقل الاستلام أو التسليم في Shipment (يُرجى الاطّلاع على is_pickup).

Timestamp

وقت بدء الزيارة يُرجى العِلم أنّ المركبة قد تصل إلى موقع الزيارة قبل هذا الوقت. تتوافق الأوقات مع ShipmentModel.

map<string, Load>

إجمالي الطلب على حمولة الزيارة هو مجموع الشحنة وطلب الزيارة load_demands. وتكون القيم سالبة إذا كانت الزيارة عبارة عن عملية تسليم. يتم تسجيل الطلبات للأنواع نفسها مثل Transition.loads (راجِع هذا الحقل).

Duration

الوقت الإضافي للانعطاف بسبب الشحنات التي تم تسليمها على المسار قبل الزيارة ووقت الانتظار المحتمل الناتج عن الأُطر الزمنية إذا كانت الزيارة مخصّصة للتسليم، يتم احتساب المسار البديل من زيارة الاستلام المقابلة ويساوي:

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

وإلا، يتم احتسابها من المركبة start_location وتكون مساوية لما يلي:

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

نسخة من Shipment.label المقابل، إذا تم تحديده في Shipment

string

نسخة من VisitRequest.label المقابل، إذا تم تحديده في VisitRequest

VisitType

اختيارية: تحدّد هذه السمة نوع الزيارة. يؤدي ذلك إلى إلغاء الحقل Visit.is_pickup.

int32

رمز مميّز غير شفاف يمثّل معلومات عن موقع جغرافي تمت زيارته

قد تتم تعبئة هذا الحقل في زيارات المسارات الناتجة عندما يتم ضبط VisitRequest.avoid_u_turns على "صحيح" لهذه الزيارة أو إذا تم ضبط ShipmentModel.avoid_u_turns على "صحيح" في الطلب OptimizeToursRequest.

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request لمزيد من التفاصيل.

string

قائمة بالأنواع غير المتوافقة تكون الشحنتان اللتان تحتويان على shipment_types مختلف من بين تلك المدرَجة "غير متوافقتَين".

IncompatibilityMode

الوضع المطبَّق على عدم التوافق

string

قائمة بأنواع الشحن البديلة التي يتطلّبها dependent_shipment_types

string

تتطلّب جميع الشحنات التي لها نوع في الحقل dependent_shipment_types زيارة شحنة واحدة على الأقل من النوع required_shipment_type_alternatives في المسار نفسه.

ملاحظة: لا يُسمح بسلاسل المتطلبات التي تعتمد فيها shipment_type على نفسها.

RequirementMode

الوضع المطبَّق على الشرط

int32

يتوافق الفهرس مع فهرس الشحنة في المصدر ShipmentModel.

string

نسخة من Shipment.label المقابل، إذا تم تحديده في Shipment

Reason

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

double

هذه نسخة من Shipment.penalty_cost، تم تضمينها هنا لتسهيل معرفة مدى خطورة الشحنة التي تم تخطيها.

تجريبي: قد يتغيّر سلوك هذا الحقل أو وجوده في المستقبل.

double

النسبة المقدَّرة للمركبات التي لا يمكنها تنفيذ عملية الشحن هذه لسبب واحد على الأقل من الأسباب أدناه. ملاحظة: يتم ملء هذا الحقل فقط عندما تتضمّن الأسباب مركبة.

تجريبي: قد يتغيّر سلوك هذا الحقل أو وجوده في المستقبل.

Code

يُرجى الرجوع إلى التعليقات في الرمز.

int32

هذه السمة مماثلة لسمة example_vehicle_index، ولكنّنا نقدّم قائمة بالمركبات المتعدّدة التي تم تحديدها. يُرجى العِلم أنّ هذه القائمة ليست شاملة بالضرورة. لا يتم ملء هذا الحقل إلا إذا كانت قيمة [fill_example_vehicle_indices_in_skipped_reasons][] هي "صحيح".

تجريبي: قد يتغيّر سلوك هذا الحقل أو وجوده في المستقبل.

string

إذا كان رمز السبب هو DEMAND_EXCEEDS_VEHICLE_CAPACITY، يشير ذلك إلى نوع واحد من السعة التي تم تجاوزها.

int32

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

Timestamp

وقت بدء الفترة الزمنية الصارمة في حال عدم تحديدها، سيتم ضبطها على ShipmentModel.global_start_time.

Timestamp

وقت انتهاء الفترة الزمنية الصارمة في حال عدم تحديدها، سيتم ضبطها على ShipmentModel.global_end_time.

Timestamp

وقت البدء المرن للنافذة الزمنية

Timestamp

وقت الانتهاء المرن للنافذة الزمنية

double

التكلفة في الساعة التي تتم إضافتها إلى التكاليف الأخرى في النموذج إذا وقع الحدث قبل soft_start_time، ويتم احتسابها على النحو التالي:

   max(0, soft_start_time - t.seconds)
                          * cost_per_hour_before_soft_start_time / 3600,
t being the time of the event.

يجب أن تكون هذه التكلفة موجبة، ولا يمكن ضبط الحقل إلا إذا تم ضبط soft_start_time.

double

التكلفة في الساعة التي تتم إضافتها إلى التكاليف الأخرى في النموذج إذا حدثت الفعالية بعد soft_end_time، ويتم احتسابها على النحو التالي:

   max(0, t.seconds - soft_end_time.seconds)
                    * cost_per_hour_after_soft_end_time / 3600,
t being the time of the event.

يجب أن تكون هذه التكلفة موجبة، ولا يمكن ضبط الحقل إلا إذا تم ضبط soft_end_time.

string

علامات تحدّد مجموعة عمليات الانتقال (من المصدر إلى الوجهة) التي تنطبق عليها هذه السمات.

تتطابق زيارة المصدر أو بداية المركبة إذا كان VisitRequest.tags أو Vehicle.start_tags يحتوي على src_tag أو لا يحتوي على excluded_src_tag (حسب أي من هذين الحقلين غير فارغ).

string

يمكنك الاطّلاع على src_tag. يجب أن تكون قيمة واحدة فقط من src_tag وexcluded_src_tag غير فارغة.

string

تتطابق زيارة الوجهة أو نهاية الرحلة بالمركبة إذا كان الحقل VisitRequest.tags أو Vehicle.end_tags يحتوي على dst_tag أو لا يحتوي على excluded_dst_tag (حسب أي من هذين الحقلين غير فارغ).

string

يمكنك الاطّلاع على dst_tag. يجب أن تكون قيمة واحدة فقط من dst_tag وexcluded_dst_tag غير فارغة.

double

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

double

تحدّد هذه السمة التكلفة لكل كيلومتر يتم تطبيقها على المسافة المقطوعة أثناء تنفيذ هذه الرحلة. تتم إضافة هذه السمة إلى أيّ سمة Vehicle.cost_per_kilometer محدّدة في المركبات.

DistanceLimit

يحدّد هذا الحقل حدًا أقصى للمسافة المقطوعة أثناء إجراء هذا الانتقال.

اعتبارًا من حزيران (يونيو) 2021، لا تتوفّر سوى الحدود غير الصارمة.

Duration

يحدّد هذا الحقل التأخير الذي يحدث عند تنفيذ هذا الانتقال.

يحدث هذا التأخير دائمًا بعد الانتهاء من زيارة المصدر وقبل بدء زيارة الوجهة.

string

معرّف الموارد المنتظم (URI) للمورد قد لا يكون المورد متوفّرًا بعد.

يتم ترميز محتوى المورد إما بتنسيق JSON أو textproto. يُسمح فقط بموارد Google Cloud Storage. إذا تم ترميز المورد بتنسيق JSON، يجب أن ينتهي اسم المورد بـ .json. إذا تم ترميز المورد كـ textproto، يجب أن ينتهي اسم المورد بـ .txtpb. على سبيل المثال، قد يظهر معرّف الموارد المنتظم (URI) لخدمة Google Cloud Storage لملف بترميز JSON على النحو التالي: gs://bucket/path/input/object.json.

string

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

TravelMode

وضع السفر الذي يؤثر في الطرق التي يمكن للمركبة استخدامها وسرعتها يمكنك أيضًا الاطّلاع على travel_duration_multiple.

RouteModifiers

مجموعة من الشروط التي يجب استيفاؤها والتي تؤثر في طريقة احتساب المسارات للمركبة المحدّدة.

LatLng

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

Waypoint

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

LatLng

الموقع الجغرافي الذي تتوقف فيه المركبة بعد إكمال آخر VisitRequest. في حال عدم تحديدها، تنتهي ShipmentRoute للمركبة فور إكمال آخر VisitRequest لها. إذا كان نموذج الشحنة يحتوي على مصفوفات المدة والمسافة، يجب عدم تحديد end_location.

Waypoint

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

string

تحدّد هذه السمة العلامات المرفقة ببداية مسار المركبة.

لا يُسمح بالسلاسل الفارغة أو المكرّرة.

string

تحدّد العلامات المرفقة بنهاية مسار المركبة.

لا يُسمح بالسلاسل الفارغة أو المكرّرة.

TimeWindow

النوافذ الزمنية التي يمكن للمركبة خلالها مغادرة موقعها الأولي ويجب أن تكون ضمن الحدود الزمنية العالمية (راجِع حقول ShipmentModel.global_*). في حال عدم تحديدها، لن يكون هناك أي قيود بخلاف تلك الحدود الزمنية العامة.

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

لا يمكن ضبط cost_per_hour_after_soft_end_time وsoft_end_time إلا إذا كانت هناك نافذة زمنية واحدة.

TimeWindow

النوافذ الزمنية التي قد تصل خلالها المركبة إلى موقعها النهائي ويجب أن تكون ضمن الحدود الزمنية العالمية (راجِع حقول ShipmentModel.global_*). في حال عدم تحديدها، لن يكون هناك أي قيود بخلاف تلك الحدود الزمنية العامة.

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

لا يمكن ضبط cost_per_hour_after_soft_end_time وsoft_end_time إلا إذا كانت هناك نافذة زمنية واحدة.

UnloadingPolicy

سياسة التفريغ المفروضة على المركبة

map<string, LoadLimit>

سعات المركبة (الوزن والحجم وعدد المنصات النقالة على سبيل المثال) المفاتيح في الخريطة هي معرّفات نوع الحمولة، وتتوافق مع مفاتيح الحقل Shipment.load_demands. إذا لم يكن هناك مفتاح معيّن في هذه الخريطة، تُعتبر السعة المقابلة غير محدودة.

double

تكاليف المركبة: يتم جمع كل التكاليف ويجب أن تكون بالوحدة نفسها المستخدَمة في Shipment.penalty_cost.

التكلفة في الساعة لمسار المركبة يتم تطبيق هذه التكلفة على إجمالي الوقت الذي يستغرقه المسار، وتشمل مدة الرحلة ووقت الانتظار ووقت الزيارة. قد يؤدي استخدام cost_per_hour بدلاً من cost_per_traveled_hour فقط إلى زيادة وقت الاستجابة.

double

التكلفة لكل ساعة من مسار المركبة يتم تطبيق هذه التكلفة فقط على مدة الرحلة التي يستغرقها المسار (أي تلك التي تم الإبلاغ عنها في ShipmentRoute.transitions)، وتستثني وقت الانتظار ووقت الزيارة.

double

التكلفة لكل كيلومتر من مسار المركبة يتم تطبيق هذه التكلفة على المسافة المذكورة في ShipmentRoute.transitions ولا تنطبق على أي مسافة يتم قطعها ضمنيًا من arrival_location إلى departure_location في VisitRequest واحد.

double

التكلفة الثابتة التي يتم تطبيقها في حال استخدام هذه المركبة لتسليم شحنة

bool

لا ينطبق هذا الحقل إلا على المركبات التي لا يخدم مسارها أي شحنات. وتشير إلى ما إذا كان يجب اعتبار المركبة مستعمَلة أم لا في هذه الحالة.

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

وإلا، لن تنتقل من موقع البداية إلى موقع النهاية، ولن تتم جدولة أي break_rule أو تأخير (من TransitionAttributes) لهذه المركبة. في هذه الحالة، لا يحتوي ShipmentRoute الخاص بالمركبة على أي معلومات باستثناء فهرس المركبة وتصنيفها.

DurationLimit

الحدّ الأقصى المطبَّق على المدة الإجمالية لمسار المركبة في OptimizeToursResponse معيّن، تكون مدة مسار المركبة هي الفرق بين vehicle_end_time وvehicle_start_time.

DurationLimit

الحدّ الأقصى المطبَّق على مدة الرحلة لمسار المركبة في OptimizeToursResponse معيّن، تكون مدة الرحلة على المسار هي مجموع كل transitions.travel_duration.

DistanceLimit

الحدّ الأقصى المطبَّق على إجمالي المسافة التي تقطعها المركبة في مسارها في OptimizeToursResponse معيّن، تكون مسافة المسار هي مجموع كل transitions.travel_distance_meters.

map<string, Duration>

تحدّد هذه السمة خريطة من سلاسل visit_types إلى المدد. المدة هي الوقت الذي يُضاف إلى VisitRequest.duration ليتم استغراقه في الزيارات التي تتضمّن visit_types المحدّد. تضيف مدة الزيارة الإضافية هذه تكلفة إذا تم تحديد cost_per_hour. لا يمكن أن تكون المفاتيح (مثل visit_types) سلاسل فارغة.

إذا كان طلب الزيارة يتضمّن أنواعًا متعدّدة، ستتم إضافة مدة لكل نوع في الخريطة.

BreakRule

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

string

تحدّد هذه السمة تصنيفًا لهذه المركبة. يتم الإبلاغ عن هذا التصنيف في الردّ على أنّه vehicle_label من ShipmentRoute المقابل.

bool

إذا كانت القيمة "صحيح"، يجب أن تكون قيمة used_if_route_is_empty "خطأ"، وستبقى هذه المركبة غير مستخدَمة.

إذا تم تنفيذ شحنة بواسطة مركبة تم تجاهلها في injected_first_solution_routes، يتم تخطّيها في الحلّ الأول ولكن يمكن تنفيذها في الاستجابة.

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

double

تحدّد هذه السمة عاملاً مضاعفًا يمكن استخدامه لزيادة أو تقليل مُدد الرحلات لهذه المركبة. على سبيل المثال، يعني ضبط هذه القيمة على 2.0 أنّ هذه المركبة أبطأ وتستغرق مدة رحلة تبلغ ضعف مدة الرحلة للمركبات العادية. لا يؤثر هذا المضاعف في مُدد الزيارات. ويؤثر في التكلفة في حال تحديد cost_per_hour أو cost_per_traveled_hour. يجب أن تكون هذه القيمة في النطاق [0.001, 1000.0]. في حال عدم ضبط هذه السمة، تكون المركبة عادية، ويتم اعتبار هذا المضاعف 1.0.

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

يمكنك أيضًا الاطّلاع على "extra_visit_duration_for_visit_type" أدناه.

Duration

حدّ صارم يفرض أن تكون المدة على الأكثر max_duration.

Duration

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

إذا تم تحديد السمة soft_max_duration، يجب أن تكون قيمتها غير سالبة. إذا تم تحديد max_duration أيضًا، يجب أن تكون قيمة soft_max_duration أقل من قيمة max_duration.

Duration

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

في حال ضبط quadratic_soft_max_duration، يجب استيفاء الشروط التالية:

• يجب أن تكون القيمة غير سالبة.
• يجب تحديد السمة max_duration.
• يجب أن تكون قيمة quadratic_soft_max_duration أقل من max_duration.
• يجب ألا يزيد الفرق عن يوم واحد: max_duration - quadratic_soft_max_duration <= 86400 seconds

double

التكلفة في الساعة التي يتم تحمّلها في حال تجاوز الحدّ الأقصى لـ soft_max_duration تكون التكلفة الإضافية 0 إذا كانت المدة أقل من الحدّ الأدنى، وإلا ستعتمد التكلفة على المدة على النحو التالي:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

يجب أن تكون التكلفة غير سالبة.

double

التكلفة لكل ساعة مربّعة يتم تحمّلها في حال تجاوز الحدّ الأقصى لـ quadratic_soft_max_duration.

تكون التكلفة الإضافية 0 إذا كانت المدة أقل من الحدّ الأدنى، وإلا ستعتمد التكلفة على المدة على النحو التالي:

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

يجب أن تكون التكلفة غير سالبة.

int64

الحدّ الأقصى المرن للحمولة يمكنك الاطّلاع على cost_per_unit_above_soft_max.

double

إذا تجاوزت الحمولة في أي وقت soft_max_load على طول مسار هذه المركبة، سيتم تطبيق غرامة التكلفة التالية (مرة واحدة فقط لكل مركبة): (الحمولة - soft_max_load) * cost_per_unit_above_soft_max. يتم جمع كل التكاليف ويجب أن تكون بالوحدة نفسها المستخدَمة في Shipment.penalty_cost. لا يجوز تحديد الحدود المرنة إلا على الأنواع التي تنطبق على عمليات الاستلام فقط أو عمليات التسليم فقط في جميع أنحاء النموذج.

Interval

تمثّل هذه السمة الفاصل الزمني المقبول للحمولة في المركبة في بداية المسار.

Interval

تمثّل هذه السمة الفاصل الزمني المقبول للحمولة في المركبة في نهاية المسار.

int64

الحد الأقصى المقبول للحِمل

LoadCost

تكلفة نقل وحدة واحدة من الحمولة لمسافة كيلومتر واحد لهذه المركبة. يمكن استخدام ذلك كمؤشر لاستهلاك الوقود: إذا كان الحِمل عبارة عن وزن (بالنيوتن)، فإنّ الحِمل*كيلومتر له بُعد الطاقة.

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request لمزيد من التفاصيل.

LoadCost

تكلفة السفر بوحدة حمولة خلال ساعة واحدة لهذه المركبة.

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request لمزيد من التفاصيل.

int64

الحد الأدنى المقبول للحِمل يجب أن تكون القيمة أكبر من أو تساوي 0. في حال تحديد كليهما، يجب أن تكون قيمة min أقل من أو تساوي قيمة max.

int64

الحد الأقصى المقبول للحِمل يجب أن تكون القيمة أكبر من أو تساوي 0. في حال عدم تحديد هذه السمة، لن تفرض هذه الرسالة أي قيود على الحد الأقصى للحمولة. في حال تحديد كليهما، يجب أن تكون قيمة min أقل من أو تساوي قيمة max.

int64

مقدار الحمولة الذي تتغيّر فوقه تكلفة نقل وحدة الحمولة من cost_per_unit_below_threshold إلى cost_per_unit_above_threshold. يجب أن تكون القيمة أكبر من أو تساوي 0.

double

تكلفة نقل وحدة من الحمولة، لكل وحدة بين 0 والحدّ الأدنى يجب أن تكون قيمة محدودة وأكبر من أو تساوي 0.

double

تكلفة نقل وحدة من الحمولة، لكل وحدة فوق الحدّ الأدنى في الحالة الخاصة التي يكون فيها الحدّ الأدنى = 0، تكون هذه التكلفة ثابتة لكل وحدة. يجب أن تكون قيمة محدودة وأكبر من أو تساوي 0.

double

الحد الأقصى لجميع الحقول الأخرى في هذه الرسالة.

double

النسبة بين AggregatedMetrics.travel_distance_meters وVehicle.route_distance_limit في حال عدم ضبط Vehicle.route_distance_limit، لن يتم ضبط هذا الحقل.

double

النسبة بين [AggregatedMetrics.travel_duration_seconds][] وVehicle.travel_duration_limit. في حال عدم ضبط Vehicle.travel_duration_limit، لن يتم ضبط هذا الحقل.

double

النسبة بين [AggregatedMetrics.total_duration_seconds][] وVehicle.route_duration_limit. في حال عدم ضبط Vehicle.route_duration_limit، لن يتم ضبط هذا الحقل.

double

الحد الأقصى للنسبة بين جميع أنواع [AggregatedMetrics.max_load][] وVehicle.load_limits المقابلة لها. إذا لم يتم ضبط جميع حقول Vehicle.load_limits، لن يتم ضبط هذا الحقل.

double

The ratio (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time) for a given vehicle. إذا لم يكن المقام متوفّرًا، يتم استخدام (ShipmentModel.global_end_time - ShipmentModel.global_start_time) بدلاً منه.

bool

اختيارية: تشير إلى أنّ الموقع الجغرافي لهذه النقطة على المسار يهدف إلى تفضيل توقّف المركبة على جانب معيّن من الطريق. عند ضبط هذه القيمة، سيمرّ المسار عبر الموقع الجغرافي لكي تتمكّن المركبة من التوقّف على جانب الطريق الذي يميل إليه الموقع الجغرافي من وسط الطريق. لا يعمل هذا الخيار مع وضع السفر "WALKING".

bool

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

تجريبي: قد يتغيّر سلوك هذا الحقل أو وجوده في المستقبل.

Location

نقطة محدّدة باستخدام الإحداثيات الجغرافية، بما في ذلك عنوان اختياري

string

رقم تعريف المكان المرتبط بنقطة المسار

عند استخدام رقم تعريف مكان لتحديد موقع الوصول أو المغادرة في VisitRequest، استخدِم رقم تعريف مكان محدّدًا بما يكفي لتحديد موقع LatLng للتنقّل إلى المكان. على سبيل المثال، يُعدّ رقم تعريف المكان الذي يمثّل مبنى مناسبًا، ولكن لا يُنصح باستخدام رقم تعريف المكان الذي يمثّل طريقًا.