تعرض Route Optimization API مسارات للمركبات في طلبك. يتم تخصيص الشحنات للمركبات أو قد يتم تخطّيها حسب خصائص الطلب.
تحتوي رسالة OptimizeToursResponse
(REST، gRPC) على مستويين رئيسيين رئيسيين.
المواقع:
routes[]
هي المسارات لكل مركبة مع الشحنات المخصّصة لها. على كل يحتويRoute
على مقاييس تعكس خصائص ذلك المسار الفردي.- تمثّل
metrics
مقاييس مجمّعة للردود بأكملها على مستوى جميع المركبات وخطط المسارات. تحتوي مقاييس المستوى الأعلى على الخصائص نفسها مثل المقاييس لكل مسار، مع القيم المجمّعة على مستوى جميع المسارات
وقد لا تتم تعبئة بعض السمات في بعض الأحيان استنادًا إلى نتائج التحسين:
- تعرض السمة
skippedShipments[]
الشحنات التي لا يتم إجراؤها بواسطة أي مركبة. يمكن تخطّي الشحنة إذا تعذّر إتمامها خلال المهلة المحددة. القيود أو إذا كانت تكلفة تنفيذ الشحنة تتجاوز تكلفة العقوبة. على سبيل المثال، إذا كان وقت استلام الشحنة أو تسليمها ضيقًا جدًاtimeWindow
قد لا تكون إحدى المركبات ممكنة أو فعّالة من حيث التكلفة إجراء الزيارة خلال الفترة الزمنية المطلوبة. - يحدّد
validationErrors[]
الأخطاء التي تجعل الطلب غير صالح أو من المستحيل حله عند ضبطsolvingMode
للطلب علىVALIDATE_ONLY
في وضعDEFAULT_SOLVE
العادي، ستظهر أخطاء التحقّق من الصحة في رسالة خطأ بدلاً من نص الاستجابة. لاحظ أن يمكن لوضع حلVALIDATE_ONLY
الإبلاغ عن أخطاء متعددة في آنٍ واحد، وهو ما يمثل مفيدة لتصحيح أخطاء الطلبات بسرعة.
خصائص المسار
كل إدخال في routes[]
هو رسالة ShipmentRoute
(REST وgRPC). على كل
تمثّل السمة ShipmentRoute
تخصيص المسار لمركبة معيّنة من
الطلب. سمات ShipmentRoute
المهمة ذات الصلة بسماتها المقابلة
تشمل Vehicle
ما يلي:
- يمثّل
vehicleIndex
فهرسًا قائمًا على صفر لـVehicle
في النطاق المقابل لطلب إرسال رسالة. تتجاهل استجابات REST هذه السمة عندما تكون القيمة صفرًا. - "
vehicleStartTime
" هو الوقت الذي يجب أن تبدأ فيه المركبة مسارها. vehicleEndTime
هو الوقت الذي يُتوقّع أن تنتهي فيه المركبة. المسار الصحيح.
في الردّ، سيظهر routes
بالشكل التالي:
{
"routes": [
{
"vehicleStartTime": "2024-02-13T00:00:00Z",
"vehicleEndTime": "2024-02-13T00:38:42Z",
"visits": [
...
],
"transitions": [
...
],
"metrics": {
...
},
...
}
],
...
}
تشمل كل ShipmentRoute
قائمة مرتّبة بقيمة visits
التي ستنفّذها المركبة.
مكتملة. يمثل كل Visit
(REST وgRPC) VisitRequest
(REST، gRPC) من الطلب ذي الصلة. مهمة Visit
وتشمل السمات ما يلي:
shipmentIndex
هو المؤشر القائم على الصفر للشحنة التي تنتمي إليها هذه الزيارة إليه في الطلب المقابل.- تكون السمة
isPickup
صحيحة عندما تكون الزيارة للاستلام وتكون خاطئة عندما تكون الزيارة. التسليم. تحذف استجابات REST هذه السمة عندما تكون القيمة خاطئة. visitRequestIndex
هو فهرس بقيمة صفرية لـVisitRequest
منShipment.pickups
أوShipment.deliveries
في الطلب المقابل التي تمثلهاVisit
. تحذف استجابات REST هذه السمة عند حذف والقيمة تساوي صفرًا.startTime
هو الوقت الذي يُتوقع أن تبدأ فيه الزيارة.- نوع تحميل الخرائط
loadDemands
لتحميل مقدار التحميل المطلوب لإكمالVisit
تكون مبالغ التحميل سلبية لزيارات التسليم، وهي تمثّل التحميل. تتم إزالتها من المركبة.
في ما يلي مثال على السمة Visit
:
{
"routes": [
{
...
"visits": [
{
"isPickup": true,
"startTime": "2024-02-13T00:00:00Z",
"detour": "0s"
},
...
],
},
...
],
...
}
يشمل كل ShipmentRoute
قائمة مرتبة من transitions
تمثّل
التنقّل بين visits
لمركبة معيّنة. رسالة Transition
مهمة
(REST، وgRPC) تشمل ما يلي:
startTime
هو الوقت الذي ستبدأ فيه المركبة في إجراء انتقالي.travelDuration
هي المدة التي يجب أن تنتقل إليها المركبة. لإكمال عملية الانتقال.travelDistanceMeters
هي المسافة بالأمتار التي يجب أن تحلّها المركبة. السفر لإكمال عملية الانتقال.- تشير قيمة
trafficInfoUnavailable
إلى ما إذا كانت بيانات حركة المرور متاحة انتقالي. - تشير السمة
waitDuration
إلى مدة عدم النشاط التي تقضيها المركبة في الانتظار قبل أن تتمكن من إجراء ذلك. تَشْغِيلُ الْـVisit
التَّالِي. وقد يحدث ذلك بسببstart_time
من تتم متابعةVisit
. totalDuration
هو إجمالي مدة النقل، بما في ذلك السفر، والانتظار والاستراحة والتأخير.- نوع تحميل الخرائط في
vehicleLoads
لمقدار حمولة المركبة أثناء الرحلة هذا الانتقال.
في ما يلي مثال على السمة Transition
:
{
"routes": [
{
...
"transitions": [
...
{
"travelDuration": "1171s",
"travelDistanceMeters": 9004,
"waitDuration": "0s",
"totalDuration": "1171s",
"startTime": "2024-02-13T00:00:00Z"
},
...
],
...
}
],
...
}
يتم توضيح العلاقة بين vists
وtransitions
في
تحسين طلبات الاستلام والتسليم، وكذلك في
ShipmentRoute
مستندات مرجعية (REST وgRPC)
خصائص المقاييس
تلخِّص رسالة Metrics
(REST، gRPC) الحل بأكمله.
تشمل بعض سمات Metrics
المهمة ما يلي:
totalCost
هو إجمالي التكلفة المترتبة على إكمال المسارات. مزيد من المعلومات عن التكاليف في معلمات نموذج التكلفة.usedVehicleCount
هو إجمالي عدد المركبات المستخدَمة في الحلّ. يمكن أن يكون للمركبات مسارات فارغة عندما يقرّر المطوّر أن استخدامها غير ضروري.skippedMandatoryShipmentCount
هو عدد الشحنات التي تم تخطيها "إلزامي". لا تحدِّد الشحنة الإلزامية سمةpenaltyCost
يتم تكبدها إذا تم تخطي الشحنة. لا يزال بإمكان الشحنات الإلزامية تخطيها إذا لم يكن أداؤها قابلاً للتنفيذ في ظل قيود محددة. اطّلع على مزيد من المعلومات عن التكاليف في معلمات نماذج التكلفة.
يتم الإبلاغ عن المقاييس الإضافية في شكل رسائل AggregatedMetrics
(REST،
gRPC). يُستخدم نوع الرسالة AggregatedMetrics
السمة Metrics.aggregatedRouteMetrics
وShipmentRoute.metrics
يحتوي الموقع "Metrics.aggregatedRouteMetrics
" على مقاييس مجمّعة على مستوى كل
ShipmentRoute
في OptimizeToursResponse
. كل ShipmentRoute.metrics
الذي يحتوي على مقاييس لهذا ShipmentRoute
تحديدًا.
تتضمّن سمات AggregatedMetrics
المهمة ما يلي:
performedShipmentCount
هو عدد الشحنات التي تؤديها المركبات على مساراتهم بالكامل.travelDuration
هو إجمالي الوقت الذي تقضيه المركبات في النقل أثناء النقل واستكمال مساراتهم.waitDuration
هو إجمالي الوقت الذي تقضيه المركبات في الانتظار أثناء إكمالها مساراتهم.delayDuration
هو إجمالي مدة التأخير للمركبات. عادة ما يكون هذا صفر ما لم يتم استخدامTransitionAttributes
في الطلب.breakDuration
هو إجمالي الوقت الذي تقضيه المركبات في فترات الاستراحة أثناء واستكمال مساراتهم.visitDuration
هو إجمالي الوقت الذي تقضيه المركبات في تنفيذ الزيارات أثناء واستكمال مساراتهم. وهذا هو مجموع كل قيمVisitRequest.duration
لـVisitRequest
بما يتوافق معVisit
المخصصة للمركبة المعنية.totalDuration
هو إجمالي المدة المطلوبة لإكمال المركبات والمسارات.travelDistanceMeters
هو إجمالي المسافة التي قطعتها المركبات أثناء واستكمال مساراتهم.maxLoads
أنواع تحميل الخرائط إلى الحد الأقصى لمقدار الحمولة الذي يتم نقله بواسطة المركبات في أي وقت على مساراتها.
يظهر مثال لرسالة Metrics
على النحو التالي:
{
"routes": [
...
],
"metrics": {
"aggregatedRouteMetrics": {
"performedShipmentCount": 1,
"travelDuration": "2322s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "0s",
"totalDuration": "2322s",
"travelDistanceMeters": 18603
},
"usedVehicleCount": 1,
"earliestVehicleStartTime": "2024-02-13T00:00:00Z",
"latestVehicleEndTime": "2024-02-13T00:38:42Z",
"totalCost": 18.603,
"costs": {
"model.vehicles.cost_per_kilometer": 18.603
}
}
}
المثال الكامل
مثال كامل لرد مكتمل على الطلب من قسم إنشاء طلب مثل:
{
"routes": [
{
"vehicleStartTime": "2024-02-13T00:00:00Z",
"vehicleEndTime": "2024-02-13T00:38:42Z",
"visits": [
{
"isPickup": true,
"startTime": "2024-02-13T00:00:00Z",
"detour": "0s"
},
{
"startTime": "2024-02-13T00:19:31Z",
"detour": "0s"
}
],
"transitions": [
{
"travelDuration": "0s",
"waitDuration": "0s",
"totalDuration": "0s",
"startTime": "2024-02-13T00:00:00Z"
},
{
"travelDuration": "1171s",
"travelDistanceMeters": 9004,
"waitDuration": "0s",
"totalDuration": "1171s",
"startTime": "2024-02-13T00:00:00Z"
},
{
"travelDuration": "1151s",
"travelDistanceMeters": 9599,
"waitDuration": "0s",
"totalDuration": "1151s",
"startTime": "2024-02-13T00:19:31Z"
}
],
"metrics": {
"performedShipmentCount": 1,
"travelDuration": "2322s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "0s",
"totalDuration": "2322s",
"travelDistanceMeters": 18603
},
"routeCosts": {
"model.vehicles.cost_per_kilometer": 18.603
},
"routeTotalCost": 18.603
}
],
"metrics": {
"aggregatedRouteMetrics": {
"performedShipmentCount": 1,
"travelDuration": "2322s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "0s",
"totalDuration": "2322s",
"travelDistanceMeters": 18603
},
"usedVehicleCount": 1,
"earliestVehicleStartTime": "2024-02-13T00:00:00Z",
"latestVehicleEndTime": "2024-02-13T00:38:42Z",
"totalCost": 18.603,
"costs": {
"model.vehicles.cost_per_kilometer": 18.603
}
}
}