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

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

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

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

القيود

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

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

الخصائص

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

يعرض الجدول التالي السمات ذات المستوى الأعلى لإعداد توجيه المركبات الكبيرة:

vehicleInfo

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

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

أمثلة

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

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

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

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

"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
      }
    ]
  }
}

الخطوات التالية

• توفير اتجاهات مفصّلة: تعرَّف على كيفية تمرير routeToken التي يتم عرضها لكل انتقال إلى حزمة تطوير البرامج للتنقّل على Android أو iOS.
• إنشاء خطوط متعددة الأضلاع للانتقال ورموز مميزة للمسار: تعرَّف على كيفية طلب رموز مميزة للمسار باستخدام populateTransitionPolylines في خطوط متعددة الأضلاع للانتقال ورموز مميزة للمسار.
• مرجع واجهة برمجة التطبيقات: يمكنك الاطّلاع على القائمة الكاملة للحقول في مرجع optimizeTours.