مسیریابی وسایل نقلیه بزرگ

مسیریابی وسایل نقلیه بزرگ مجموعه‌ای از ویژگی‌ها است که به شما امکان می‌دهد مسیرهای ناوگان را برای وسایل نقلیه بزرگ با مشخص کردن ابعاد فیزیکی، وزن و تعداد تریلرها بهینه کنید. API از این ویژگی‌ها برای محاسبه مسیرهای ممکن استفاده می‌کند که از جاده‌های محدود، پل‌های کم ارتفاع یا مسیرهای با وزن محدود جلوگیری می‌کنند.

با مسیریابی وسایل نقلیه بزرگ، می‌توانید چالش‌های لجستیکی ناوگان را برای وسایل نقلیه سنگین و بزرگ حل کنید، به عنوان مثال:

  • اجتناب از خطرات جاده‌ای: نقشه‌های مسیری ایجاد کنید که وسایل نقلیه را از ارتفاع کم بالای سر، جاده‌های با محدودیت وزن و سایر خطرات فیزیکی دور نگه دارد.
  • اطلاعات دقیق وسیله نقلیه را مشخص کنید: ابعاد دقیق، وزن کل، تعداد محورها و پیکربندی تریلر را در برنامه‌های مسیر کل ناوگان لحاظ کنید.
  • بهبود برنامه‌ریزی در سطح ناوگان: برنامه‌های مسیر کارآمدی برای کل ناوگان کامیون خود بسازید و در عین حال اطمینان حاصل کنید که تمام تخصیص‌ها با محدودیت‌های فیزیکی جاده مطابقت دارند.

محدودیت‌ها

قبل از شروع، باید از محدودیت‌ها و الزامات زیر آگاه باشید.

  • دسترسی جغرافیایی : مسیریابی وسایل نقلیه بزرگ فقط در ۴۸ ایالت مجاور ایالات متحده در دسترس است.
  • هشدار و ایمنی راننده : رانندگان نباید صرفاً به مسیرهایی که توسط این API برای ایمن یا قانونی بودن ارائه می‌شوند، تکیه کنند. تضمینی وجود ندارد که مسیرها برای وسیله نقلیه مناسب باشند و دنبال کردن آنها ممکن است رانندگان را در معرض خطراتی مانند پل‌های کوتاه یا جاده‌هایی که عبور وسایل نقلیه بزرگ از آنها ممنوع است، قرار دهد.
  • مسیرهای با بهترین تلاش : در برخی موارد، API نمی‌تواند مسیری را پیدا کند که کاملاً با محدودیت‌های سفر مطابقت داشته باشد. در عوض، یک مسیر "بهترین تلاش" را برمی‌گرداند که هنوز ممکن است از مناطق محدود شده عبور کند.
  • ویژگی‌های پشتیبانی نشده : مسیریابی وسایل نقلیه بزرگ از موارد زیر پشتیبانی نمی‌کند:
    • قیمت عوارض کامیون
    • محدودیت‌های سرعت
    • مسیریابی مواد خطرناک رادیواکتیو
  • صورتحساب: گوگل برای همه درخواست‌های optimizeTours به ​​طور یکسان صورتحساب صادر می‌کند، صرف نظر از اینکه آیا این درخواست‌ها ویژگی‌های مسیریابی وسایل نقلیه بزرگ را پیکربندی می‌کنند یا خیر.
  • مسیرهای طولانی: مسیرهای کامیونی طولانی که ۵۰۰ کیلومتر یا بیشتر را پوشش می‌دهند، به زمان محاسبه بیشتری نسبت به مسیرهای کوتاه‌تر نیاز دارند و ممکن است داده‌های مسیر با کیفیت پایین‌تری را برگردانند. برای حفظ کیفیت مسیر، فواصل بین محموله‌ها، مکان‌های شروع وسیله نقلیه و مکان‌های پایان وسیله نقلیه را محدود کنید. اگر به مسیرهای طولانی نیاز دارید، مهلت‌های درخواست خود را افزایش دهید تا احتمال خطاهای DEADLINE_EXCEEDED کاهش یابد.

خواص

برای استفاده از ویژگی‌های مسیریابی وسایل نقلیه بزرگ، باید وسیله نقلیه را با ابعاد فیزیکی آن پیکربندی کنید و حالت مسیریابی آن را روی کامیون تنظیم کنید.

جدول زیر ویژگی‌های سطح بالا برای پیکربندی مسیریابی وسایل نقلیه بزرگ را فهرست می‌کند:

ملک نوع مورد نیاز توضیحات
travelMode رشته مورد نیاز حالت سفر را برای وسیله نقلیه مشخص می‌کند. برای فعال کردن ویژگی‌های مسیریابی وسایل نقلیه بزرگ، این مقدار را روی TRUCK تنظیم کنید.
routeModifiers شیء مورد نیاز شامل پیکربندی‌های مختص مسیر، از جمله vehicleInfo است.

vehicleInfo

شیء vehicleInfo شامل مشخصات فیزیکی وسیله نقلیه است. این شیء را در ویژگی routeModifiers تعریف کنید. در صورت تنظیم travelMode روی TRUCK ارائه شیء vehicleInfo الزامی است .

جدول زیر لیست ویژگی‌های موجود در شیء vehicleInfo را نشان می‌دهد:

ملک نوع مورد نیاز توضیحات
totalHeightMm عدد صحیح مورد نیاز ارتفاع کل وسیله نقلیه را بر حسب میلی‌متر مشخص می‌کند. این مقدار باید یک عدد صحیح مثبت باشد.
totalWidthMm عدد صحیح مورد نیاز عرض کل وسیله نقلیه را بر حسب میلی‌متر مشخص می‌کند. این مقدار باید یک عدد صحیح مثبت باشد.
totalWeightKg عدد صحیح مورد نیاز وزن کل وسیله نقلیه را بر حسب کیلوگرم مشخص می‌کند. این مقدار باید یک عدد صحیح مثبت باشد.
totalLengthMm عدد صحیح مورد نیاز طول کل وسیله نقلیه را بر حسب میلی‌متر مشخص می‌کند. این مقدار باید یک عدد صحیح مثبت باشد.
trailerInfo آرایه اختیاری شامل آرایه‌ای از مشخصات تریلر است که شامل ویژگی lengthMm برای مشخص کردن طول هر تریلر به صورت جداگانه بر حسب میلی‌متر می‌شود.
totalAxleCount عدد صحیح مورد نیاز تعداد کل محورهای وسیله نقلیه را مشخص می‌کند. این مقدار باید یک عدد صحیح بزرگتر یا مساوی ۲ باشد.

مثال‌ها

این بخش شامل دو نوع مثال است:

نمونه کد

مثال زیر ساختار ویژگی‌های مورد استفاده برای مسیریابی وسایل نقلیه بزرگ را نشان می‌دهد:

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