ShipmentRoute

يمكن تقسيم مسار المركبة على طول محور الوقت على النحو التالي (نفترض أنّ هناك n زيارة):

  |            |            |          |       |  T[2], |        |      |
  | Transition |  Visit #0  |          |       |  V[2], |        |      |
  |     #0     |    aka     |   T[1]   |  V[1] |  ...   | V[n-1] | T[n] |
  |  aka T[0]  |    V[0]    |          |       | V[n-2],|        |      |
  |            |            |          |       | T[n-1] |        |      |
  ^            ^            ^          ^       ^        ^        ^      ^
vehicle    V[0].start   V[0].end     V[1].   V[1].    V[n].    V[n]. vehicle
 start     (arrival)   (departure)   start   end      start    end     end

يُرجى العِلم أنّنا نفرق بين:

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

القيم الثابتة:

  • إذا كانت هناك n زيارة، تكون هناك n+1 انتقال.
  • تكون الزيارة محاطة دائمًا بانتقال قبلها (الفهرس نفسه) وانتقال بعدها (الفهرس + 1).
  • يتبع بدء تشغيل المركبة دائمًا الانتقال رقم 0.
  • تكون نهاية المركبة دائمًا مسبوقة بعلامة الانتقال رقم n.

في ما يلي ما يحدث عند تكبير Transition وVisit:

---+-------------------------------------+-----------------------------+-->
   |           TRANSITION[i]             |           VISIT[i]          |
   |                                     |                             |
   |  * TRAVEL: the vehicle moves from   |      PERFORM the visit:     |
   |    VISIT[i-1].departure_location to |                             |
   |    VISIT[i].arrival_location, which |  * Spend some time:         |
   |    takes a given travel duration    |    the "visit duration".    |
   |    and distance                     |                             |
   |                                     |  * Load or unload           |
   |  * BREAKS: the driver may have      |    some quantities from the |
   |    breaks (e.g. lunch break).       |    vehicle: the "demand".   |
   |                                     |                             |
   |  * WAIT: the driver/vehicle does    |                             |
   |    nothing. This can happen for     |                             |
   |    many reasons, for example when   |                             |
   |    the vehicle reaches the next     |                             |
   |    event's destination before the   |                             |
   |    start of its time window         |                             |
   |                                     |                             |
   |  * DELAY: *right before* the next   |                             |
   |    arrival. E.g. the vehicle and/or |                             |
   |    driver spends time unloading.    |                             |
   |                                     |                             |
---+-------------------------------------+-----------------------------+-->
   ^                                     ^                             ^
V[i-1].end                           V[i].start                    V[i].end

أخيرًا، إليك كيفية ترتيب TRAVEL، وBREAKS، و المحسّن، وWAIT أثناء عملية النقل.

  • ولا تتداخل هذه المجموعات.
  • يكون DELAY فريدًا ويجب أن يكون فترة زمنية متصلة مباشرةً قبل الزيارة التالية (أو نهاية المركبة). وبالتالي، يكفي معرفة مدة التأخير لمعرفة وقت البدء والانتهاء.
  • الفواصل الزمنية هي فترات زمنية متجاورة وغير متداخلة. يحدِّد الردّ وقت بدء كل استراحة ومدتها.
  • TRAVEL وWAIT "قابلة للاستبدال": يمكن مقاطعتهما عدة مرات أثناء هذا الانتقال. يمكن للعملاء افتراض أنّ الرحلة تتم "في أقرب وقت ممكن" وأنّ "الانتظار" يملؤون الوقت المتبقّي.

مثال (معقد):

                               TRANSITION[i]
--++-----+-----------------------------------------------------------++-->
  ||     |       |           |       |           |         |         ||
  ||  T  |   B   |     T     |       |     B     |         |    D    ||
  ||  r  |   r   |     r     |   W   |     r     |    W    |    e    ||
  ||  a  |   e   |     a     |   a   |     e     |    a    |    l    ||
  ||  v  |   a   |     v     |   i   |     a     |    i    |    a    ||
  ||  e  |   k   |     e     |   t   |     k     |    t    |    y    ||
  ||  l  |       |     l     |       |           |         |         ||
  ||     |       |           |       |           |         |         ||
--++-----------------------------------------------------------------++-->
تمثيل JSON 
{
  "vehicleIndex": integer,
  "vehicleLabel": string,
  "vehicleStartTime": string,
  "vehicleEndTime": string,
  "visits": [
    {
      object (Visit)
    }
  ],
  "transitions": [
    {
      object (Transition)
    }
  ],
  "hasTrafficInfeasibilities": boolean,
  "routePolyline": {
    object (EncodedPolyline)
  },
  "breaks": [
    {
      object (Break)
    }
  ],
  "metrics": {
    object (AggregatedMetrics)
  },
  "routeCosts": {
    string: number,
    ...
  },
  "routeTotalCost": number
}
الحقول
vehicleIndex

integer

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

string

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

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
vehicleEndTime

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
visits[]

object (Visit)

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

object (Transition)

قائمة عمليات النقل المطلوبة للمسار.
hasTrafficInfeasibilities

boolean

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

  startTime(previous_visit) + duration(previous_visit) +
  travelDuration(previous_visit, next_visit) > startTime(next_visit)

من المحتمل أن تحدث الوصول في وقت Next_visit بعد الفترة الزمنية الحالية، وذلك بسبب الزيادة المقدّرة في وقت السفر بمقدار travelDuration(previous_visit, next_visit) بسبب عدد الزيارات. وقد يتداخل وقت الاستراحة أيضًا مع وقت الزيارة بسبب زيادة تقديرات وقت التنقّل والقيود المفروضة على وقت الزيارة أو وقت الاستراحة.
routePolyline

object (EncodedPolyline)

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

object (Break)

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

object (AggregatedMetrics)

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

map (key: string, value: number)

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

number

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

انتقال

زيارة تم إجراؤها أثناء مسار تتطابق هذه الزيارة مع عملية استلام أو تسليم Shipment.

تمثيل JSON 
{
  "shipmentIndex": integer,
  "isPickup": boolean,
  "visitRequestIndex": integer,
  "startTime": string,
  "loadDemands": {
    string: {
      object (Load)
    },
    ...
  },
  "detour": string,
  "shipmentLabel": string,
  "visitLabel": string
}
الحقول
shipmentIndex

integer

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

boolean

في حال كانت القيمة true، تتجاوب الزيارة مع طلب استلام Shipment. بخلاف ذلك، يشير إلى عملية تسليم.
visitRequestIndex

integer

مؤشر VisitRequest إما في حقل الاستلام أو التسليم في Shipment (راجِع isPickup).
startTime

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
loadDemands

map (key: string, value: object (Load))

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

string (Duration format)

وقت الانحراف الإضافي بسبب الشحنات التي تمت زيارتها على المسار قبل الزيارة وفترة الانتظار المحتملة الناتجة عن الفترات الزمنية. إذا كانت الزيارة عبارة عن عملية تسليم، يتم احتساب المسار غير المباشر من زيارة الاستلام المقابلة لها، وهو يساوي:

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

بخلاف ذلك، يتم احتسابها من المركبة startLocation ويساوي:

startTime - vehicleStartTime - travel duration from
the vehicle's `startLocation` to the visit.

مدة بالثواني تضم تسعة أرقام كسور كحد أقصى وتنتهي بـ "s"، مثال: "3.5s"
shipmentLabel

string

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

string

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

انتقالات

الانتقال بين حدثَين على المسار يمكنك الاطّلاع على وصف ShipmentRoute.

إذا لم تكن المركبة مزوّدة برمز startLocation و/أو endLocation، تكون مقاييس التنقّل المقابلة لها 0.

تمثيل JSON 
{
  "travelDuration": string,
  "travelDistanceMeters": number,
  "trafficInfoUnavailable": boolean,
  "delayDuration": string,
  "breakDuration": string,
  "waitDuration": string,
  "totalDuration": string,
  "startTime": string,
  "routePolyline": {
    object (EncodedPolyline)
  },
  "routeToken": string,
  "vehicleLoads": {
    string: {
      object (VehicleLoad)
    },
    ...
  }
}
الحقول
travelDuration

string (Duration format)

مدة السفر أثناء هذه الفترة الانتقالية.

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
travelDistanceMeters

number

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

boolean

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

string (Duration format)

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

مدة بالثواني تضم تسعة أرقام كسور كحد أقصى وتنتهي بـ "s"، مثال: "3.5s"
breakDuration

string (Duration format)

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

مدة بالثواني تضم تسعة أرقام كسور كحد أقصى وتنتهي بـ "s"، مثال: "3.5s"
waitDuration

string (Duration format)

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

مدة بالثواني تضم تسعة أرقام كسور كحد أقصى وتنتهي بـ "s"، مثال: "3.5s"
totalDuration

string (Duration format)

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

  • الزيارة التالية startTime (أو vehicleEndTime إذا كانت هذه هي عملية النقل الأخيرة) - startTime لهذا النقل؛
  • إذا كانت قيمة ShipmentRoute.has_traffic_infeasibilities خاطئة، ينطبق ما يلي أيضًا على: `totalDuration = travelDuration + delayDuration.
  • ‫breakDuration + waitDuration`.

مدة بالثواني تضم تسعة أرقام كسور كحد أقصى وتنتهي بـ "s"، مثال: "3.5s"
startTime

string (Timestamp format)

وقت بدء عملية النقل هذه

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
routePolyline

object (EncodedPolyline)

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

string

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

map (key: string, value: object (VehicleLoad))

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

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

EncodedPolyline

التمثيل المشفَّر لخط متعدد. يمكنك العثور على مزيد من المعلومات حول ترميز الخطوط المتعددة هنا: https://developers.google.com/maps/documentation/utilities/polylinealgorithm https://developers.google.com/maps/documentation/javascript/reference/geometry#encoding.

تمثيل JSON 
{
  "points": string
}
الحقول
points

string

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

استراحة

يشير ذلك المصطلح إلى البيانات التي تمثّل تنفيذ الاستراحة.

تمثيل JSON 
{
  "startTime": string,
  "duration": string
}
الحقول
startTime

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
duration

string (Duration format)

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

مدة بالثواني تضم تسعة أرقام كسور كحد أقصى وتنتهي بـ "s"، مثال: "3.5s"