توجيه المركبات الكبيرة

ملاحظة: تتوفّر ميزة "تحديد مسارات المركبات الكبيرة" لمجموعة محدودة من العملاء. يُرجى التواصل معنا للتعبير عن اهتمامك.

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

باستخدام ميزة "تحديد مسارات المركبات الكبيرة"، يمكنك حلّ التحديات اللوجستية لأسطول المركبات الثقيلة والكبيرة، على سبيل المثال:

• تجنُّب المخاطر على الطرق: يمكنك إنشاء خطط مسارات توجّه المركبات بعيدًا عن الطرق التي تخضع لقيود على الوزن أو التي يكون فيها ارتفاع الجسور منخفضًا والمخاطر المادية الأخرى.
• تحديد معلومات مفصّلة عن المركبة: يمكنك دمج الأبعاد الدقيقة والوزن الإجمالي وعدد المحاور وإعدادات المقطورة في خطط المسارات على مستوى الأسطول.
• تحسين التخطيط على مستوى الأسطول: يمكنك إنشاء خطط مسارات فعّالة لأسطول الشاحنات بالكامل مع ضمان امتثال جميع المهام للقيود المادية على الطرق.

القيود

قبل البدء، يجب أن تكون على دراية بالقيود والمتطلبات التالية.

• التوفّر الجغرافي: لا تتوفّر ميزة "تحديد مسارات المركبات الكبيرة" إلا في الولايات المتحدة الـ 48 المتجاورة.
• إرشادات السائق والسلامة: يجب ألا يعتمد السائقون فقط على المسارات التي تعرضها واجهة برمجة التطبيقات هذه لضمان سلامتها أو قانونيتها. لا نضمن أن تكون المسارات مناسبة للمركبة، وقد يؤدي اتّباعها إلى تعريض السائقين لمخاطر، مثل الجسور المنخفضة أو الطرق التي يُحظر فيها استخدام المركبات الكبيرة.
• المسارات التي يتم بذل قصارى الجهد للعثور عليها: في بعض الحالات، لا يمكن لواجهة برمجة التطبيقات العثور على مسار يتوافق تمامًا مع قيود السفر. بدلاً من ذلك، تعرض واجهة برمجة التطبيقات مسارًا "يتم بذل قصارى الجهد للعثور عليه" قد يمرّ بمناطق محظورة.
• الميزات غير المتوافقة: لا تتيح ميزة "تحديد مسارات المركبات الكبيرة" ما يلي:
  • رسوم العبور للشاحنات
  • حدود السرعة
  • تحديد مسارات نقل المواد الخطرة المشعّة
• الفوترة: تفرض Google رسومًا موحّدة على جميع طلبات optimizeTours، بغض النظر عمّا إذا كانت الطلبات تضبط سمات ميزة "تحديد مسارات المركبات الكبيرة" .
• المسارات الطويلة: تتطلب مسارات الشاحنات الطويلة التي تمتدّ لمسافة 500 كيلومتر أو أكثر وقتًا أطول للمعالجة مقارنةً بالمسارات الأقصر، وقد تعرض بيانات مسارات أقل جودة. للحفاظ على جودة المسار، يجب الحدّ من المسافات بين الشحنات ومواقع بدء المركبات ومواقع انتهاء المركبات. إذا كنت بحاجة إلى مسارات طويلة، يمكنك زيادة المواعيد النهائية لطلباتك لتقليل احتمالية حدوث أخطاء DEADLINE_EXCEEDED.

الخصائص

لاستخدام سمات ميزة "تحديد مسارات المركبات الكبيرة"، عليك ضبط مركبة بأبعادها المادية وضبط وضع تحديد المسارات على "شاحنة".

يعرض الجدول التالي السمات ذات المستوى الأعلى لضبط ميزة "تحديد مسارات المركبات الكبيرة":

الموقع	النوع	المتطلبات	الوصف
travelMode	سلسلة	مطلوب	تحدّد هذه السمة وضع السفر للمركبة. لتفعيل سمات ميزة "تحديد مسارات المركبات الكبيرة"، اضبط هذه القيمة على TRUCK.
routeModifiers	عنصر	مطلوب	يحتوي هذا العنصر على إعدادات خاصة بالمسار، بما في ذلك vehicleInfo.

vehicleInfo

يحتوي العنصر vehicleInfo على المواصفات المادية للمركبة. يمكنك تحديد هذا العنصر ضمن السمة routeModifiers. يجب تقديم العنصر vehicleInfo إذا ضبطت travelMode على TRUCK.

يعرض الجدول التالي السمات المتاحة ضمن العنصر vehicleInfo object:

الموقع	النوع	المتطلبات	الوصف
totalHeightMm	عدد صحيح	مطلوب	تحدّد هذه السمة الارتفاع الإجمالي للمركبة بالملليمترات. يجب أن تكون هذه القيمة عددًا صحيحًا موجبًا.
totalWidthMm	عدد صحيح	مطلوب	تحدّد هذه السمة العرض الإجمالي للمركبة بالملليمترات. يجب أن تكون هذه القيمة عددًا صحيحًا موجبًا.
totalWeightKg	عدد صحيح	مطلوب	تحدّد هذه السمة الوزن الإجمالي للمركبة بالكيلوغرامات. يجب أن تكون هذه القيمة عددًا صحيحًا موجبًا.
totalLengthMm	عدد صحيح	مطلوب	تحدّد هذه السمة الطول الإجمالي للمركبة بالملليمترات. يجب أن تكون هذه القيمة عددًا صحيحًا موجبًا.
trailerInfo	صفيف	اختياري	يحتوي هذا العنصر على صفيف من مواصفات المقطورة، بما في ذلك السمة lengthMm لتحديد طول كل مقطورة على حدة بالملليمترات.
totalAxleCount	عدد صحيح	مطلوب	تحدّد هذه السمة العدد الإجمالي للمحاور في المركبة. يجب أن تكون هذه القيمة عددًا صحيحًا أكبر من أو يساوي 2.

أمثلة

يغطّي هذا القسم نوعَين من الأمثلة:

• عيّنة تعليمات برمجية توضّح بنية ميزة "تحديد مسارات المركبات الكبيرة".
• مثال على طلب يتضمّن الميزة

عيّنة تعليمات برمجية

يوضّح المثال التالي بنية السمات المستخدَمة في ميزة "تحديد مسارات المركبات الكبيرة":

"vehicles": [
  {
    "travelMode": "TRUCK",
    "routeModifiers": {
      "vehicleInfo": {
        "totalHeightMm": TOTAL_HEIGHT_MM,
        "totalWidthMm": TOTAL_WIDTH_MM,
        "totalWeightKg": TOTAL_WEIGHT_KG,
        "totalLengthMm": TOTAL_LENGTH_MM,
        "trailerInfo": [
          {
            "lengthMm": TRAILER_LENGTH_MM
          }
        ],
        "totalAxleCount": TOTAL_AXLE_COUNT
      }
    }
  }
]

مثال على الطلب

يوضّح المثال التالي بنية طلب optimizeTours أساسي يتضمّن ميزة "تحديد مسارات المركبات الكبيرة":

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 40.953523,
              "longitude": -72.2277846
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 40.9546673,
              "longitude": -72.2580151
            }
          }
        ]
      }
    ],
    "vehicles": [
      {
        "travelMode": "TRUCK",
        "routeModifiers": {
          "vehicleInfo": {
            "totalHeightMm": 4000,
            "totalWidthMm": 2500,
            "totalWeightKg": 9000,
            "totalLengthMm": 20000,
            "trailerInfo": [
              {
                "lengthMm": 15000
              }
            ],
            "totalAxleCount": 5
          }
        },
        "costPerKilometer": 1.0
      }
    ]
  }
}