AggregatedMetrics
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
| تمثيل JSON |
{
"performedShipmentCount": integer,
"travelDuration": string,
"waitDuration": string,
"delayDuration": string,
"breakDuration": string,
"visitDuration": string,
"totalDuration": string,
"travelDistanceMeters": number,
"maxLoads": {
string: {
object (VehicleLoad)
},
...
},
"performedMandatoryShipmentCount": integer,
"performedShipmentPenaltyCostSum": number
} |
| الحقول |
performedShipmentCount |
integer
عدد عمليات الشحن التي تم إجراؤها يُرجى العلم أنّه يتم احتساب زوج الاستلام والتسليم مرّة واحدة فقط.
|
travelDuration |
string (Duration format)
إجمالي مدة التنقّل في مسار أو حلّ المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
|
waitDuration |
string (Duration format)
إجمالي مدة الانتظار لمسار أو حلّ المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
|
delayDuration |
string (Duration format)
إجمالي مدة التأخير لمسار أو حلّ المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
|
breakDuration |
string (Duration format)
إجمالي مدة الفاصل الزمني لمسار أو حلّ المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
|
visitDuration |
string (Duration format)
إجمالي مدة الزيارة لمسار أو حلّ المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
|
totalDuration |
string (Duration format)
يجب أن يكون إجمالي المدة مساويًا لمجموع جميع المدّات أعلاه. بالنسبة إلى المسارات، يتوافق ذلك أيضًا مع:
[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]
المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
|
travelDistanceMeters |
number
إجمالي مسافة التنقّل لمسار أو حلّ
|
maxLoads |
map (key: string, value: object (VehicleLoad))
الحد الأقصى للحمولة التي تمّ تحقيقها على طول المسار بالكامل (أو الحلّ)، لكلّ من الكميّات على هذا المسار (أو الحلّ)، ويتم احتسابه على أنّه الحدّ الأقصى لجميع Transition.vehicle_loads (أو ShipmentRoute.metrics.max_loads.
|
performedMandatoryShipmentCount |
integer
عدد عمليات الشحن الإلزامية التي تم إجراؤها تجريبي: قد يتغيّر سلوك هذا الحقل أو وجوده في المستقبل.
|
performedShipmentPenaltyCostSum |
number
مجموع Shipment.penalty_cost للشحنات التي تم إجراؤها. تجريبي: قد يتغيّر سلوك هذا الحقل أو وجوده في المستقبل.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis document outlines the aggregated metrics for ShipmentRoute and OptimizeToursResponse within Google Maps Route Optimization.\u003c/p\u003e\n"],["\u003cp\u003eMetrics include shipment count, travel/wait/delay/break/visit/total durations, travel distance, and maximum loads.\u003c/p\u003e\n"],["\u003cp\u003eAll durations are represented in seconds with up to nine fractional digits using the Duration format.\u003c/p\u003e\n"],["\u003cp\u003eMaximum loads are provided as a map, keyed by quantity and valued by the corresponding VehicleLoad object.\u003c/p\u003e\n"],["\u003cp\u003eThese metrics offer insights into the overall performance and resource utilization of routes and solutions.\u003c/p\u003e\n"]]],[],null,["# AggregatedMetrics\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nAggregated metrics for [ShipmentRoute](/maps/documentation/route-optimization/reference/rest/v1/ShipmentRoute) (resp. for [OptimizeToursResponse](/maps/documentation/route-optimization/reference/rest/v1/OptimizeToursResponse) over all [Transition](/maps/documentation/route-optimization/reference/rest/v1/ShipmentRoute#Transition) and/or [Visit](/maps/documentation/route-optimization/reference/rest/v1/ShipmentRoute#Visit) (resp. over all [ShipmentRoute](/maps/documentation/route-optimization/reference/rest/v1/ShipmentRoute)) elements.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"performedShipmentCount\": integer, \"travelDuration\": string, \"waitDuration\": string, \"delayDuration\": string, \"breakDuration\": string, \"visitDuration\": string, \"totalDuration\": string, \"travelDistanceMeters\": number, \"maxLoads\": { string: { object (/maps/documentation/route-optimization/reference/rest/v1/VehicleLoad) }, ... }, \"performedMandatoryShipmentCount\": integer, \"performedShipmentPenaltyCostSum\": number } ``` |\n\n| Fields ||\n|-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `performedShipmentCount` | `integer` Number of shipments performed. Note that a pickup and delivery pair only counts once. |\n| `travelDuration` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` Total travel duration for a route or a solution. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `waitDuration` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` Total wait duration for a route or a solution. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `delayDuration` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` Total delay duration for a route or a solution. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `breakDuration` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` Total break duration for a route or a solution. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `visitDuration` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` Total visit duration for a route or a solution. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `totalDuration` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` The total duration should be equal to the sum of all durations above. For routes, it also corresponds to: [ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time] A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `travelDistanceMeters` | `number` Total travel distance for a route or a solution. |\n| `maxLoads` | `map (key: string, value: object (`[VehicleLoad](/maps/documentation/route-optimization/reference/rest/v1/VehicleLoad)`))` Maximum load achieved over the entire route (resp. solution), for each of the quantities on this route (resp. solution), computed as the maximum over all [Transition.vehicle_loads](/maps/documentation/route-optimization/reference/rest/v1/ShipmentRoute#Transition.FIELDS.vehicle_loads) (resp. [ShipmentRoute.metrics.max_loads](/maps/documentation/route-optimization/reference/rest/v1/AggregatedMetrics#FIELDS.max_loads). |\n| `performedMandatoryShipmentCount` | `integer` Number of mandatory shipments performed. Experimental: This field's behavior or existence may change in future. |\n| `performedShipmentPenaltyCostSum` | `number` The sum of the [Shipment.penalty_cost](/maps/documentation/route-optimization/reference/rest/v1/ShipmentModel#Shipment.FIELDS.penalty_cost) of the performed shipments. Experimental: This field's behavior or existence may change in future. |"]]
