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 وDELAY و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 على true، يشير هذا الحقل إلى أنّه يتم توقّع حدوث تناقضات في أوقات المسار باستخدام تقديرات مدة التنقّل المستندة إلى عدد المركبات. قد لا يكون هناك وقت كافٍ لإكمال التنقّل والتأخيرات والفواصل الزمنية بين الزيارات، قبل الزيارة الأولى أو بعد الزيارة الأخيرة، مع مواصلة استيفاء الفترات الزمنية للزيارات والمركبات. على سبيل المثال،

  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

إذا كانت القيمة صحيحة، تشير الزيارة إلى استلام 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 + longDuration`.

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "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".