ShipmentModel

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

  • تكلفة توجيه المركبات (مجموع التكلفة لكل إجمالي الوقت والتكلفة لكل وقت السفر والتكلفة الثابتة على جميع المركبات)
  • عقوبات الشحن غير المُنفَّذة.
  • تكلفة المدة الزمنية الإجمالية للشحنات
تمثيل JSON 
{
  "shipments": [
    {
      object (Shipment)
    }
  ],
  "vehicles": [
    {
      object (Vehicle)
    }
  ],
  "globalStartTime": string,
  "globalEndTime": string,
  "globalDurationCostPerHour": number,
  "durationDistanceMatrices": [
    {
      object (DurationDistanceMatrix)
    }
  ],
  "durationDistanceMatrixSrcTags": [
    string
  ],
  "durationDistanceMatrixDstTags": [
    string
  ],
  "transitionAttributes": [
    {
      object (TransitionAttributes)
    }
  ],
  "shipmentTypeIncompatibilities": [
    {
      object (ShipmentTypeIncompatibility)
    }
  ],
  "shipmentTypeRequirements": [
    {
      object (ShipmentTypeRequirement)
    }
  ],
  "precedenceRules": [
    {
      object (PrecedenceRule)
    }
  ],
  "maxActiveVehicles": integer
}
الحقول
shipments[]

object (Shipment)

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

object (Vehicle)

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

string (Timestamp format)

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

يجب أن تكون الفترة الزمنية للنموذج أقل من سنة، أي يجب أن تكون الفترة الزمنية بين globalEndTime وglobalStartTime ضمن 31536000 ثانية لكل منهما.

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

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

string (Timestamp format)

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

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

number

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

object (DurationDistanceMatrix)

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

أمثلة على استخدام هذه الكلمة في جملة:

  • يوجد موقعان: locA وlocB.
  • مركبة واحدة تبدأ مسارها عند locA وتنتهي عند locA.
  • طلب زيارة لاستلام واحد في الموقع الجغرافي
model {
  vehicles { startTags: "locA"  endTags: "locA" }
  shipments { pickups { tags: "locB" } }
  durationDistanceMatrixSrcTags: "locA"
  durationDistanceMatrixSrcTags: "locB"
  durationDistanceMatrixDstTags: "locA"
  durationDistanceMatrixDstTags: "locB"
  durationDistanceMatrices {
    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 وlocC.
  • مركبة واحدة تبدأ مسارها من الموقع الجغرافي "أ" وتنتهي به في الموقع الجغرافي "ب"، باستخدام مصفوفة "سريع".
  • مركبة واحدة تبدأ مسارها في locB وتنتهي في locB، باستخدام المصفوفة "بطيء".
  • مركبة واحدة تبدأ مسارها في locB وتنتهي في locB، باستخدام مصفوفة "fast".
  • طلب زيارة استلام واحد في الموقع الجغرافي (ج).
model {
  vehicles { startTags: "locA" endTags: "locB" startTags: "fast" }
  vehicles { startTags: "locB" endTags: "locB" startTags: "slow" }
  vehicles { startTags: "locB" endTags: "locB" startTags: "fast" }
  shipments { pickups { tags: "locC" } }
  durationDistanceMatrixSrcTags: "locA"
  durationDistanceMatrixSrcTags: "locB"
  durationDistanceMatrixSrcTags: "locC"
  durationDistanceMatrixDstTags: "locB"
  durationDistanceMatrixDstTags: "locC"
  durationDistanceMatrices {
    vehicleStartTag: "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
    }
  }
  durationDistanceMatrices {
    vehicleStartTag: "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
    }
  }
}
durationDistanceMatrixSrcTags[]

string

علامات تحدد مصادر مصفوفات المدة والمسافة؛ وتحدد durationDistanceMatrices(i).rows(j) المدد والمسافات بين الزيارات ذات العلامة durationDistanceMatrixSrcTags(j) إلى الزيارات الأخرى في المصفوفة 1.

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

string

العلامات التي تحدّد وجهات مصفوفتَي المدة والمسافة؛ durationDistanceMatrices(i).rows(j).durations(k) (resp. تحدِّد durationDistanceMatrices(i).rows(j).meters(k)) مدة التنقّل (أو المسافة) من الزيارات التي تحمل العلامة durationDistanceMatrixSrcTags(j) إلى الزيارات التي تحمل العلامة durationDistanceMatrixDstTags(k) في المصفوفة i.

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

object (TransitionAttributes)

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

object (ShipmentTypeIncompatibility)

مجموعات من أنواع الشحن غير المتوافقة (راجِع ShipmentTypeIncompatibility).
shipmentTypeRequirements[]

object (ShipmentTypeRequirement)

مجموعات متطلبات shipmentType (راجِع ShipmentTypeRequirement)
precedenceRules[]

object (PrecedenceRule)

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

integer

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

الشحن

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

تمثيل JSON 
{
  "displayName": string,
  "pickups": [
    {
      object (VisitRequest)
    }
  ],
  "deliveries": [
    {
      object (VisitRequest)
    }
  ],
  "loadDemands": {
    string: {
      object (Load)
    },
    ...
  },
  "allowedVehicleIndices": [
    integer
  ],
  "costsPerVehicle": [
    number
  ],
  "costsPerVehicleIndices": [
    integer
  ],
  "pickupToDeliveryAbsoluteDetourLimit": string,
  "pickupToDeliveryTimeLimit": string,
  "shipmentType": string,
  "label": string,
  "ignore": boolean,
  "penaltyCost": number,
  "pickupToDeliveryRelativeDetourLimit": number
}
الحقول
displayName

string

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

object (VisitRequest)

مجموعة بدائل الاستلام المرتبطة بالشحن في حال عدم تحديد موقع جغرافي، يجب أن تنتقل المركبة إلى موقع جغرافي يتوافق مع عمليات التسليم.
deliveries[]

object (VisitRequest)

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

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

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

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
allowedVehicleIndices[]

integer

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

number

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

  • على نفس عدد العناصر مثل costsPerVehicleIndices. costsPerVehicle[i] تتوافق مع المركبة costsPerVehicleIndices[i] من الطراز.
  • عدد العناصر نفسه لعدد المركبات في النموذج يتجاوب العنصر i-th مع المركبة رقم i للنموذج.

ويجب أن تكون هذه التكاليف في الوحدة نفسها مثل penaltyCost وألا تكون سالبة. اترك هذا الحقل فارغًا إذا لم تكن هناك تكاليف من هذا النوع.
costsPerVehicleIndices[]

integer

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

string (Duration format)

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

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

startTime(delivery) - startTime(pickup) <=
t + pickupToDeliveryAbsoluteDetourLimit

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

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

string (Duration format)

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

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

string

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

تختلف عن قيمة visitTypes المحدّدة لزيارة واحدة: تتشارك كلّ عمليات الاستلام أو التسليم التي تنتمي إلى الشحنة نفسها سمة shipmentType نفسها.
label

string

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

boolean

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

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

يُسمح بتجاهل الشحنة التي يتم تنفيذها في injectedFirstSolutionRoutes أو injectedSolutionConstraint، تزيل أداة الحلّ زيارات الاستلام أو التسليم ذات الصلة من مسار الإحالة الناجحة. وسيتم أيضًا تجاهل precedenceRules التي تشير إلى شحنات تم تجاهلها.
penaltyCost

number

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

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

number

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

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

startTime(delivery) - startTime(pickup) <=
std::ceil(t * (1.0 + pickupToDeliveryRelativeDetourLimit))

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

VisitRequest

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

تمثيل JSON 
{
  "arrivalLocation": {
    object (LatLng)
  },
  "arrivalWaypoint": {
    object (Waypoint)
  },
  "departureLocation": {
    object (LatLng)
  },
  "departureWaypoint": {
    object (Waypoint)
  },
  "tags": [
    string
  ],
  "timeWindows": [
    {
      object (TimeWindow)
    }
  ],
  "duration": string,
  "cost": number,
  "loadDemands": {
    string: {
      object (Load)
    },
    ...
  },
  "visitTypes": [
    string
  ],
  "label": string
}
الحقول
arrivalLocation

object (LatLng)

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

object (Waypoint)

نقطة الطريق التي تصل إليها المركبة عند إجراء VisitRequest إذا كان نموذج الشحن يتضمّن مصفوفات المسافة حسب المدة، يجب عدم تحديد arrivalWaypoint.
departureLocation

object (LatLng)

الموقع الجغرافي الذي تغادر منه المركبة بعد إكمال هذا VisitRequest. ويمكن حذفها إذا كانت مماثلة للسمة arrivalLocation. إذا كان نموذج الشحن يتضمّن مصفوفات المسافة حسب المدة، يجب عدم تحديد departureLocation.
departureWaypoint

object (Waypoint)

نقطة التوقف التي تغادر منها المركبة بعد إكمال هذا VisitRequest. يمكن حذفه إذا كان مطابقًا لـ arrivalWaypoint. إذا كان نموذج الشحن يتضمّن مصفوفات المسافة حسب المدة، يجب عدم تحديد departureWaypoint.
tags[]

string

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

object (TimeWindow)

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

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

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

لا يمكن ضبط costPerHourAfterSoftEndTime وsoftEndTime إلا إذا كانت هناك فترة زمنية واحدة.
duration

string (Duration format)

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

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

number

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

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

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

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
visitTypes[]

string

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

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

string

تُحدِّد تصنيفًا لهذا VisitRequest. يتم تسجيل هذا التصنيف في الردّ على أنّه visitLabel في ShipmentRoute.Visit المقابل.

LatLng

عنصر يمثّل زوجًا من خطوط العرض/خطوط الطول ويتم التعبير عن ذلك في صورة زوج من الزوجين لتمثيل درجات الطول والعرض والدرجات. يجب أن يتوافق هذا العنصر مع معيار WGS84 ما لم يُذكر خلاف ذلك. يجب أن تكون القيم ضمن النطاقات العادية.

تمثيل JSON 
{
  "latitude": number,
  "longitude": number
}
الحقول
latitude

number

خط العرض بالدرجات. يجب أن يكون ضمن النطاق [-90.0, +90.0].
longitude

number

خط الطول بالدرجات. يجب أن يكون في النطاق [ -180.0، +180.0].

النقطة الوسيطة

تُغلِّف نقطة طريق. تشير نقاط الطرق إلى مواقع وصول ومغادرة طلبات الزيارات، ومواقع بدء المركبات ونهايتها.

تمثيل JSON 
{
  "sideOfRoad": boolean,

  // Union field location_type can be only one of the following:
  "location": {
    object (Location)
  },
  "placeId": string
  // End of list of possible types for union field location_type.
}
الحقول
sideOfRoad

boolean

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

object (Location)

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

string

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

الموقع الجغرافي

تُحاط بموقع جغرافي (نقطة جغرافية وعنوان اختياري).

تمثيل JSON 
{
  "latLng": {
    object (LatLng)
  },
  "heading": integer
}
الحقول
latLng

object (LatLng)

الإحداثيات الجغرافية لنقطة الطريق
heading

integer

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

TimeWindow

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

تفرض حدود الفترة الزمنية الثابتة، startTime وendTime، أقرب وقت وآخر وقت للحدث، على النحو التالي: startTime <= event_time <= endTime. يُعرب عن الحد الأدنى لفترة زمنية مبدئية، softStartTime، عن تفضيله لوقوع الحدث في softStartTime أو بعده من خلال تحمُّل تكلفة متناسبة مع المدة التي تسبق softStartTime بوقت وقوع الحدث. يُعرِّف الحد الأقصى لفترة زمنية مبدئية، softEndTime، عن تفضيله لوقوع الحدث في softEndTime أو قبله من خلال تحمُّل تكلفة متناسبة مع المدة بعد softEndTime وقوع الحدث. يجب أن تكون القيم startTime وendTime وsoftStartTime وsoftEndTime ضمن الحدود الزمنية العامة (راجِع ShipmentModel.global_start_time وShipmentModel.global_end_time) وأن تلتزم بما يلي:

  0 <= `startTime` <= `softStartTime` <= `endTime` and
  0 <= `startTime` <= `softEndTime` <= `endTime`.
تمثيل JSON 
{
  "startTime": string,
  "endTime": string,
  "softStartTime": string,
  "softEndTime": string,
  "costPerHourBeforeSoftStartTime": number,
  "costPerHourAfterSoftEndTime": number
}
الحقول
startTime

string (Timestamp format)

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

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

string (Timestamp format)

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

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

string (Timestamp format)

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

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

string (Timestamp format)

وقت الانتهاء البسيط للنافذة الزمنية.

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

number

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

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

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

number

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

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

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

مركبة

تصمم مركبة في مشكلة شحن. سيؤدي حلّ مشكلة الشحن إلى إنشاء مسار يبدأ من startLocation وينتهي في endLocation لهذه المركبة. المسار هو تسلسل من الزيارات (راجِع ShipmentRoute).

تمثيل JSON 
{
  "displayName": string,
  "travelMode": enum (TravelMode),
  "routeModifiers": {
    object (RouteModifiers)
  },
  "startLocation": {
    object (LatLng)
  },
  "startWaypoint": {
    object (Waypoint)
  },
  "endLocation": {
    object (LatLng)
  },
  "endWaypoint": {
    object (Waypoint)
  },
  "startTags": [
    string
  ],
  "endTags": [
    string
  ],
  "startTimeWindows": [
    {
      object (TimeWindow)
    }
  ],
  "endTimeWindows": [
    {
      object (TimeWindow)
    }
  ],
  "unloadingPolicy": enum (UnloadingPolicy),
  "loadLimits": {
    string: {
      object (LoadLimit)
    },
    ...
  },
  "costPerHour": number,
  "costPerTraveledHour": number,
  "costPerKilometer": number,
  "fixedCost": number,
  "usedIfRouteIsEmpty": boolean,
  "routeDurationLimit": {
    object (DurationLimit)
  },
  "travelDurationLimit": {
    object (DurationLimit)
  },
  "routeDistanceLimit": {
    object (DistanceLimit)
  },
  "extraVisitDurationForVisitType": {
    string: string,
    ...
  },
  "breakRule": {
    object (BreakRule)
  },
  "label": string,
  "ignore": boolean,
  "travelDurationMultiple": number
}
الحقول
displayName

string

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

enum (TravelMode)

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

object (RouteModifiers)

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

object (LatLng)

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

object (Waypoint)

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

object (LatLng)

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

object (Waypoint)

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

string

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

لا يُسمح باستخدام سلاسل فارغة أو مكرّرة.
endTags[]

string

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

لا يُسمح باستخدام سلاسل فارغة أو مكرّرة.
startTimeWindows[]

object (TimeWindow)

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

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

لا يمكن ضبط costPerHourAfterSoftEndTime وsoftEndTime إلا إذا كانت هناك فترة زمنية واحدة.
endTimeWindows[]

object (TimeWindow)

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

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

لا يمكن ضبط costPerHourAfterSoftEndTime وsoftEndTime إلا في حال تحديد فترة زمنية واحدة.
unloadingPolicy

enum (UnloadingPolicy)

يتم فرض سياسة إلغاء التحميل على المركبة.
loadLimits

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

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

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
costPerHour

number

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

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

number

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

number

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

number

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

boolean

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

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

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

object (DurationLimit)

الحدّ الذي يتم تطبيقه على إجمالي مدة مسار المركبة في OptimizeToursResponse معيّن، تكون مدة مسار المركبة هي الفرق بين vehicleEndTime وvehicleStartTime.
travelDurationLimit

object (DurationLimit)

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

object (DistanceLimit)

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

map (key: string, value: string (Duration format))

تحدِّد هذه السياسة خريطة من سلاسل trafficTypes إلى المُدد. المدة هي الوقت بالإضافة إلى VisitRequest.duration الذي يتم اتخاذه في الزيارات ذات الصلة visitTypes المحددة. تؤدي مدّة الزيارة الإضافية هذه إلى إضافة تكلفة في حال تحديد costPerHour. لا يمكن أن تكون المفاتيح (مثل visitTypes) سلاسل فارغة.

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

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
breakRule

object (BreakRule)

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

string

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

boolean

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

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

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

number

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

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

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

TravelMode

وسائل النقل التي يمكن استخدامها من قِبل المركبات

يجب أن تكون هذه الإعدادات مجموعة فرعية من أوضاع التنقّل في واجهة برمجة التطبيقات "الطرق المفضّلة" في "منصّة خرائط Google"، راجِع: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/Shared.Types/RouteTravelMode.

عمليات التعداد
TRAVEL_MODE_UNSPECIFIED وضع سفر غير محدّد، ما يعادل DRIVING
DRIVING وضع التنقّل المرتبط باتجاهات القيادة (سيارة، وما إلى ذلك)
WALKING وضع السفر المرتبط باتجاهات المشي
TRUCK السفر بالشاحنة سيشمل هذا الوضع قيودًا مادية وقانونية.

RouteModifiers

تُحاط مجموعة من الشروط الاختيارية التي يجب استيفاؤها عند احتساب مسارات المركبات. وهذا يشبه RouteModifiers في واجهة برمجة التطبيقات المفضَّلة لتطبيق Routes في "خرائط Google". اطّلِع على: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/Shared.Types/RouteModifiers.

تمثيل JSON 
{
  "vehicleInfo": {
    object (VehicleInfo)
  }
}
الحقول
vehicleInfo

object (VehicleInfo)

تُستخدَم لتحديد معلومات المركبة.

VehicleInfo

يتم تغليف معلومات المركبة، مثل معلومات الشاحنة.

تمثيل JSON 
{
  "totalAxleCount": integer,
  "totalHeightMm": string,
  "totalLengthMm": string,
  "totalWidthMm": string,
  "totalWeightKg": string,
  "trailerInfo": [
    {
      object (TrailerInfo)
    }
  ],
  "hazardousGoodsTypes": [
    enum (HazardousGoodsType)
  ]
}
الحقول
totalAxleCount

integer

إجمالي عدد المحاور يجب أن يكون أكبر من أو يساوي 2. يجب ضبطه لبدء النقل بالشاحنات أو المقطورات. ينطبق ذلك على وضع السفر TRUCK فقط.
totalHeightMm

string (int64 format)

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

string (int64 format)

طول المركبة، بما في ذلك أطوال أي مقطورات مرفقة يجب ضبطه لتشغيل عمليات النقل بالشاحنات أو المقطورات. ينطبق ذلك على وضع السفر TRUCK فقط.
totalWidthMm

string (int64 format)

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

string (int64 format)

وزن المركبة، بما في ذلك أوزان أي مقطورات مرفقة ويشير الوزن في هذا السياق إلى الوزن الفعلي وليس تصنيف الوزن. يجب ضبطه لبدء النقل بالشاحنات أو المقطورات. ينطبق ذلك على وضع السفر TRUCK فقط.
trailerInfo[]

object (TrailerInfo)

ينطبق ذلك على وضع السفر TRUCK فقط.
hazardousGoodsTypes[]

enum (HazardousGoodsType)

قائمة بالمواد الخطيرة التي يتم نقلها في المركبة، إن وجدت

TrailerInfo

معلومات حول المقطورات الفردية المرتبطة بالمركبة يجب تقديم أطوال أي مقطورات لنقلها بالشاحنات. يجب أن يشمل إجمالي السمات سمات أي مقاطع دعائية. على سبيل المثال، يجب أن تكون قيمة totalHeightMm دائمًا أكبر من أو تساوي trailerInfo.height_mm.

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

string (int64 format)

مدة المقطع الدعائي

HazardousGoodsType

أنواع المواد الخطيرة المختلفة

عمليات التعداد
HAZARDOUS_GOODS_TYPE_UNSPECIFIED لم يتم تحديد أي نوع من السلع الخطرة.
EXPLOSIVES السلع المتفجّرة.
GASES غازات
FLAMMABLE السلع القابلة للاشتعال
COMBUSTIBLE السلع القابلة للاشتعال
ORGANIC السلع العضوية:
POISON السلع السامة
RADIOACTIVE السلع المشعة:
CORROSIVE السلع المسببة للتآكل
ASPIRATION_HAZARD السلع الخطيرة التي يتم استنشاقها
ENVIRONMENTAL_HAZARD السلع الخطيرة للبيئة
OTHER أنواع أخرى من السلع

UnloadingPolicy

سياسة حول كيفية تفريغ حمولة المركبة لا ينطبق إلا على الشحنات التي تتضمّن عملية استلام وتسليم.

يمكن إجراء شحنات أخرى في أي مكان على المسار بشكل مستقل عن unloadingPolicy.

عمليات التعداد
UNLOADING_POLICY_UNSPECIFIED سياسة تفريغ غير محدّدة، يجب أن تتم عمليات التسليم بعد عمليات الاستلام المقابلة لها.
LAST_IN_FIRST_OUT يجب أن تتم عمليات التسليم بترتيب عكسي لعمليات الاستلام.
FIRST_IN_FIRST_OUT يجب أن تتم عمليات التسليم بالترتيب نفسه الذي تم به استلام الطلبات.

LoadLimit

تحدد هذه السمة حد الحمولة الذي ينطبق على المركبة، على سبيل المثال "يمكن لهذه الشاحنة أن تحمل حتى 3, 500 كلغ كحد أقصى". يمكنك الاطّلاع على loadLimits.

تمثيل JSON 
{
  "softMaxLoad": string,
  "costPerUnitAboveSoftMax": number,
  "startLoadInterval": {
    object (Interval)
  },
  "endLoadInterval": {
    object (Interval)
  },
  "maxLoad": string
}
الحقول
softMaxLoad

string (int64 format)

حد أدنى بسيط للتحميل. يمكنك الاطّلاع على costPerUnitAboveSoftMax.
costPerUnitAboveSoftMax

number

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

object (Interval)

الفاصل الزمني المقبول لتحميل المركبة في بداية المسار
endLoadInterval

object (Interval)

الفاصل الزمني المقبول لتحميل المركبة في نهاية المسار
maxLoad

string (int64 format)

الحد الأقصى المسموح به للحمل

الفاصل

الفاصل الزمني لمقدار الحمل المقبول

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

string (int64 format)

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

string (int64 format)

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

DurationLimit

حدّ يحدّد الحدّ الأقصى لمدة مسار مركبة يمكن أن يكون صلبًا أو لينًا.

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

تمثيل JSON 
{
  "maxDuration": string,
  "softMaxDuration": string,
  "quadraticSoftMaxDuration": string,
  "costPerHourAfterSoftMax": number,
  "costPerSquareHourAfterQuadraticSoftMax": number
}
الحقول
maxDuration

string (Duration format)

حدّ ثابت يفرض ألا تتجاوز المدة maxDuration

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

string (Duration format)

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

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

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

string (Duration format)

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

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

maxDuration - quadraticSoftMaxDuration <= 86400 seconds

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

number

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

  costPerHourAfterSoftMax * (duration - softMaxDuration)

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

number

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

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

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

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

DistanceLimit

حد يحدد أقصى مسافة يمكن قطعها. يمكن أن يكون صلبًا أو لينًا.

إذا تم تحديد حدّ أدنى، يجب تحديد كلّ من softMaxMeters وcostPerKilometerAboveSoftMax وعدم استخدام قيم غير سالبة.

تمثيل JSON 
{
  "maxMeters": string,
  "softMaxMeters": string,
  "costPerKilometerAboveSoftMax": number
}
الحقول
maxMeters

string (int64 format)

حد صارم يقيد المسافة لتكون maxMeters. يجب أن يكون الحد قيمة غير سالبة.
softMaxMeters

string (int64 format)

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

إذا تم تحديد softMaxMeters، يجب أن تكون أقل من maxMeters ويجب أن تكون قيمة غير سالبة.
costPerKilometerAboveSoftMax

number

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

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

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

BreakRule

قواعد لإنشاء استراحة زمنية للمركبة (مثل استراحات الغداء) الفاصل هو فترة زمنية متصلة تظل خلالها المركبة في وضع السكون في موقعها الحالي ولا يمكنها إجراء أي زيارة. قد يحدث انقطاع في البث في الحالات التالية:

  • أثناء السفر بين زيارتين (ويشمل ذلك الوقت قبل الزيارة أو بعدها مباشرة، ولكن ليس في منتصف الزيارة)، وفي هذه الحالة، يمتد وقت النقل المقابل بين الزيارات
  • أو قبل بدء تشغيل المركبة (قد لا يتم تشغيل المركبة في منتصف فترة الراحة)، وفي هذه الحالة لا يؤثر ذلك في وقت بدء تشغيل المركبة.
  • أو بعد انتهاء المركبة (كما هو الحال، مع وقت انتهاء المركبة).
تمثيل JSON 
{
  "breakRequests": [
    {
      object (BreakRequest)
    }
  ],
  "frequencyConstraints": [
    {
      object (FrequencyConstraint)
    }
  ]
}
الحقول
breakRequests[]

object (BreakRequest)

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

object (FrequencyConstraint)

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

BreakRequest

ويجب معرفة تسلسل الفواصل الإعلانية (أي أرقامها وترتيبها) التي تنطبق على كل مركبة مسبقًا. تحدِّد العناصر BreakRequest المتكرّرة هذا التسلسل بالترتيب الذي يجب أن تحدث به. قد تتداخل الفترات الزمنية (earliestStartTime / latestStartTime)، ولكن يجب أن تكون متوافقة مع الطلب (تم وضع علامة في هذا المربّع).

تمثيل JSON 
{
  "earliestStartTime": string,
  "latestStartTime": string,
  "minDuration": string
}
الحقول
earliestStartTime

string (Timestamp format)

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

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

string (Timestamp format)

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

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

string (Duration format)

مطلوب. تمثّل هذه السمة الحد الأدنى لمدة الفاصل. يجب أن تكون موجبة.

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

قيد_التردد

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

{
   minBreakDuration { seconds: 3600 }         # 1 hour.
   maxInterBreakDuration { seconds: 39600 }  # 11 hours (12 - 1 = 11).
}

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

وقد تنطبق FrequencyConstraint عمليًا على الفواصل الإعلانية غير المتتالية. على سبيل المثال، يلتزم الجدول التالي بمثال "ساعة واحدة كل 12 ساعة":

  04:00 vehicle start
   .. performing travel and visits ..
  09:00 1 hour break
  10:00 end of the break
   .. performing travel and visits ..
  12:00 20-min lunch break
  12:20 end of the break
   .. performing travel and visits ..
  21:00 1 hour break
  22:00 end of the break
   .. performing travel and visits ..
  23:59 vehicle end
تمثيل JSON 
{
  "minBreakDuration": string,
  "maxInterBreakDuration": string
}
الحقول
minBreakDuration

string (Duration format)

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

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

string (Duration format)

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

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

DurationDistanceMatrix

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

تمثيل JSON 
{
  "rows": [
    {
      object (Row)
    }
  ],
  "vehicleStartTag": string
}
الحقول
rows[]

object (Row)

تُستخدَم لتحديد صفوف مصفوفة المدة والمسافة. يجب أن يحتوي على عدد العناصر نفسه مثل ShipmentModel.duration_distance_matrix_src_tags.
vehicleStartTag

string

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

يجب أن تتطابق جميع مرات بدء مركبة مع مصفوفة واحدة بالضبط، أي يجب أن يتطابق حقل واحد بالضبط من حقول startTags مع vehicleStartTag في إحدى المصفوفة (وهذه المصفوفة فقط).

يجب أن يكون لكل المصفوفات vehicleStartTag مختلف.

الصف

تحدّد هذه السمة صفًا من مصفوفة المدة والمسافة.

تمثيل JSON 
{
  "durations": [
    string
  ],
  "meters": [
    number
  ]
}
الحقول
durations[]

string (Duration format)

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

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

number

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

TransitionAttributes

تُحدِّد سمات الانتقالات بين زيارتَين متتاليتَين على مسار. قد تنطبق عدة TransitionAttributes على عملية النقل نفسها: في هذه الحالة، تُجمع كل التكاليف الإضافية ويتم تطبيق القيود أو الحدود الأكثر صرامة (وفقًا للدلالات الطبيعية لعبارة "و").

تمثيل JSON 
{
  "srcTag": string,
  "excludedSrcTag": string,
  "dstTag": string,
  "excludedDstTag": string,
  "cost": number,
  "costPerKilometer": number,
  "distanceLimit": {
    object (DistanceLimit)
  },
  "delay": string
}
الحقول
srcTag

string

علامات تحدّد مجموعة التحولات (src->dst) التي تنطبق عليها هذه السمات

تتطابق زيارة المصدر أو بدء المركبة إذا كانت VisitRequest.tags أو Vehicle.start_tags تحتوي على srcTag أو لا تحتوي على excludedSrcTag (اعتمادًا على الحقلَين غير فارغَين).
excludedSrcTag

string

يمكنك الاطّلاع على srcTag. يجب ألا يكون حقل واحد فقط من srcTag وexcludedSrcTag فارغًا.
dstTag

string

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

string

يمكنك الاطّلاع على dstTag. يجب أن يكون dstTag أو excludedDstTag واحدًا فقط غير فارغ.
cost

number

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

number

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

object (DistanceLimit)

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

اعتبارًا من 2021/6، ستتم إتاحة الحدود القصوى المسموح بها فقط.
delay

string (Duration format)

تحدد هذه السياسة التأخير الذي يحدث عند إجراء عملية النقل هذه.

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

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

ShipmentTypeIncompatibility

تُحدِّد حالات عدم التوافق بين الشحنات استنادًا إلى shipmentType. يتم حظر ظهور الشحنات غير المتوافقة على المسار نفسه استنادًا إلى وضع عدم التوافق.

تمثيل JSON 
{
  "types": [
    string
  ],
  "incompatibilityMode": enum (IncompatibilityMode)
}
الحقول
types[]

string

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

enum (IncompatibilityMode)

تم تطبيق الوضع على عدم التوافق.

IncompatibilityMode

أوضاع تحدّد كيفية حظر ظهور الشحنات غير المتوافقة على المسار نفسه

عمليات التعداد
INCOMPATIBILITY_MODE_UNSPECIFIED وضع عدم التوافق غير محدّد يجب عدم استخدام هذه القيمة مطلقًا.
NOT_PERFORMED_BY_SAME_VEHICLE في هذا الوضع، لا يمكن أبدًا لشحنتَين غير متوافقتَين أن تتشاركا المركبة نفسها.
NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY

في عمليتَي شحن بأنواع غير متوافقة مع وضع عدم التوافق "NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY":

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

ShipmentTypeRequirement

تحدّد هذه السمة المتطلبات بين عمليات الشحن استنادًا إلى سمة "ShippingType". يتم تحديد تفاصيل المتطلّب حسب وضع المتطلّب.

تمثيل JSON 
{
  "requiredShipmentTypeAlternatives": [
    string
  ],
  "dependentShipmentTypes": [
    string
  ],
  "requirementMode": enum (RequirementMode)
}
الحقول
requiredShipmentTypeAlternatives[]

string

تتضمّن هذه السمة قائمة بأنواع الشحن البديلة المطلوبة بموجب سياسة "dependentShipmentTypes".
dependentShipmentTypes[]

string

يجب الانتقال إلى المسار نفسه للاطّلاع على كل الشحنات من النوع requiredShipmentTypeAlternatives في الحقل dependentShipmentTypes.

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

enum (RequirementMode)

الوضع الذي تم تطبيقه على الشرط

RequirementMode

الأوضاع التي تحدد مظهر الشحنات التابعة على المسار.

عمليات التعداد
REQUIREMENT_MODE_UNSPECIFIED وضع متطلبات غير محدّد يجب عدم استخدام هذه القيمة مطلقًا.
PERFORMED_BY_SAME_VEHICLE في هذا الوضع، يجب أن تتشارك جميع الشحنات "التابعة" المركبة نفسها مع شحنة واحدة على الأقل من الشحنات "المطلوبة".
IN_SAME_VEHICLE_AT_PICKUP_TIME

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

لذلك، يجب أن يتضمّن استلام الشحنة "التابع" أيًا مما يلي:

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

PrecedenceRule

قاعدة الأولوية بين حدثَين (كل حدث هو استلام أو تسليم شحنة): يجب أن يبدأ الحدث "الثاني" بعد offsetDuration على الأقل من بدء الحدث "الأول".

يمكن أن تشير عدة أولويات إلى الأحداث نفسها (أو ذات الصلة)، على سبيل المثال: "يتم استلام الطلب (ب) بعد تسليم الطلب (أ)" و"يتم استلام الطلب (ج) بعد استلام الطلب (ب)".

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

تمثيل JSON 
{
  "firstIsDelivery": boolean,
  "secondIsDelivery": boolean,
  "offsetDuration": string,
  "firstIndex": integer,
  "secondIndex": integer
}
الحقول
firstIsDelivery

boolean

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

boolean

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

string (Duration format)

المعادلة بين الحدث "الأول" و"الثاني". يمكن أن تكون سلبية.

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

integer

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

integer

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