مدل هزینه، مدل هزینه

The cost properties are defined under ShipmentModel.shipments.Shipment and ShipmentModel.vehicles.Vehicle

هدف اصلی Route Optimization API یافتن مسیرهایی با کمترین هزینه است. به این ترتیب، مدل هزینه محرک اصلی برای بهینه‌سازی مسیر است.

مدل هزینه مجموعه ای از خواص است که هزینه های جهانی، وسیله نقلیه و حمل و نقل را مشخص می کند.

ویژگی های مدل هزینه از انواع اهداف بهینه سازی زیر پشتیبانی می کند:

  • تکالیف و مسیرهای خودرو کارآمد
  • زمان تحویل و تحویل مقرون به صرفه
  • اولویت بندی محموله های حیاتی

ساختار

همانطور که در نمودار نشان داده شده است، ویژگی های مدل هزینه به صورت زیر ساخته شده است:

این سند فقط پارامترهای اساسی مدل هزینه را برجسته می کند . برای مجموعه کامل پارامترهای هزینه به مستندات مرجع مراجعه کنید.

چک لیست ملزومات

چک لیست زیر دانش ضروری را توصیف می کند که از اشتباهات احتمالی مرتبط با هزینه جلوگیری می کند. این لیست می تواند به شما کمک کند تا درخواست خود را تأیید کنید و پاسخ خود را عیب یابی کنید.

خواص

جدول زیر ویژگی های مدل هزینه را فهرست و توصیف می کند.

پدر و مادر نام ملک نوع ملک هزینه به ازای هر توضیحات ملک
Shipment penaltyCost شماره حمل و نقل نادیده گرفته شد هزینه ای که با صرف نظر از حمل و نقل انجام می شود.
زمانی که هزینه تکمیل آن از هزینه جریمه آن بیشتر شود، API از یک محموله صرف نظر می کند.
  • تنظیم penaltyCost تحویل محموله ها با هزینه بالاتر را در اولویت قرار می دهد.
  • عدم تعیین penaltyCost ارسال را اجباری می کند.
  • تعیین صریح penaltyCost ارسال بر روی صفر باعث می شود API همیشه از ارسال صرف نظر کند مگر اینکه محدودیت های دیگر لازم باشد.
Vehicle fixedCost شماره حمل و نقل اگر از این وسیله نقلیه برای حمل و نقل استفاده شود، هزینه ثابت اعمال می شود.
costPerHour شماره ساعت هزینه کار با وسیله نقلیه در ساعت شامل زمان حمل و نقل، انتظار، بازدید و استراحت.
با افزایش این هزینه، بهینه‌ساز تلاش می‌کند مسیرهای سریع‌تری را پیدا کند که ممکن است کوتاه‌ترین مسیرها نباشند.
این ویژگی به دلیل سادگی و کامل بودن می تواند هزینه مستقل و موثری برای هر وسیله نقلیه باشد.
costPerKilometer شماره کیلومتر هزینه هر کیلومتر طی شده توسط وسیله نقلیه، مانند هزینه سوخت و هزینه های مستهلک شده تعمیر و نگهداری خودرو.
costPerTraveledHour شماره ساعت هزینه کارکرد یک وسیله نقلیه در ساعت فقط در حین حمل و نقل ، به استثنای زمان انتظار، بازدید و استراحت. این اولویت مسیرهای سفر سریعتر را نسبت به مسیرهای کوتاهتر دارد.

نمونه ها

این بخش سه نوع مثال را پوشش می دهد:

  • نمونه کدهایی که ساختار ویژگی های مدل هزینه را نشان می دهند.
  • یک سناریوی نمونه که یک راه برای استفاده از ویژگی های مدل هزینه برای دستیابی به یک هدف تجاری را نشان می دهد.
  • یک مثال درخواست که شامل مقادیر تنظیم شده در سناریوی مثال است.

نمونه کد

نمونه کد زیر ساختار ویژگی های مدل هزینه در Shipment را نشان می دهد:

{
  "model": {
    "shipments": [ ...
      {
        "penaltyCost": PENALTY_COST
      }
    ],
    "vehicles": [ ...
    ]
  }
}

نمونه کد زیر ساختار ویژگی های مدل هزینه را در Vehicle نشان می دهد:

{
  "model": {
    "shipments": [ ...
    ],
    "vehicles": [ ...
      {
        "fixedCost": FIXED_COST,
        "costPerKilometer": KILOMETER_COST,
        "costPerHour": HOUR_COST,
        "costPerTraveledHour": TRAVELED_HOUR_COST
      }
    ]
  }
}

سناریوی نمونه

این بخش سناریویی را توضیح می‌دهد که در آن شما یک کسب و کار مهد کودک سگ دارید. شما در حال بهینه سازی مسیری برای کامیونی هستید که برای بردن سگ ها از خانه هایشان استفاده می کنید. در این سناریو، شما می خواهید که بهینه ساز هنگام ارائه مسیر، هزینه های مربوط به برداشتن سگ ها و عملیات وسیله نقلیه را در نظر بگیرد.

برای این مثال، یک واحد هزینه نشان دهنده 1 دلار است. این بدان معناست که مقادیر ویژگی مدل هزینه در درخواست شما به شرح زیر است:

اموال ارزش سناریو
penaltyCost 10 نشان‌دهنده جریمه‌ای است که به مشتریان خود برای نگرفتن سگشان در یک روز برنامه‌ریزی شده ارائه می‌دهید. هر زمان که سگ را در یک روز برنامه ریزی شده تحویل نگیرید، مشتری 40 دلار از مجموع خدمات خود تخفیف دریافت می کند.
fixedCost 30 نشان دهنده هزینه روزانه پرداخت وام وسیله نقلیه شما است که 30 دلار در روز است.
costPerKilometer 0.08 نشان دهنده میزان مصرف بنزین خودروی شما در هر کیلومتر است. وسیله نقلیه شما برای حرکت به 0.04 گالن در هر کیلومتر نیاز دارد و هزینه هر گالن در منطقه شما 2 دلار است.
costPerHour 27 نشان دهنده مبلغی است که برای رانندگی وسیله نقلیه خود به راننده پرداخت می کنید. شما ساعتی 27 دلار به راننده می پردازید.
costPerTraveledHour 2.5 نشان دهنده میزان هزینه ای است که باید برای تهویه مطبوع وسیله نقلیه در ساعت برای سگ ها در حالی که در جاده هستید بپردازید. هر زمان که وسیله نقلیه حرکت نمی کند، راننده می تواند درهای عقب را باز کند و تهویه مطبوع را خاموش کند.

بر اساس پارامترهای هزینه، بهینه ساز می تواند معاوضه هایی را انجام دهد که برای کاربر واضح نیست، اما می تواند از طریق بهینه سازی پیدا شود.

نمودار زیر مثالی را نشان می‌دهد که در آن بهینه‌ساز می‌تواند مسیر طولانی‌تر اما سریع‌تری را از طریق خط چین سبز انتخاب کند تا از ترافیک روی خط قرمز نقطه‌چین جلوگیری کند.

The vehicle has two possible routes, one represented by a green dashed line, which is longer but doesn't have any incidents, and one represented by a red dotted line, which is shorter but has a car crash in the middle of it.

در این سناریو، تراز هزینه دو مسیر به شرح زیر است:

  • خط چین سبز دارای costPerHour و costPerTraveledHour کم است زیرا مسیری سریع است که از ترافیک جلوگیری می کند، که حتی زمانی که costPerKilometer بالا باشد مقرون به صرفه تر است.

  • خط نقطه قرمز دارای costPerKilometer پایین است زیرا یک مسیر مستقیم است، اما costPerHour و costPerTraveledHour به دلیل زمان انتظار در ترافیک بسیار زیاد است و آن را به گران ترین مسیر تبدیل می کند.

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

درخواست نمونه

مثال زیر ساختار یک درخواست اولیه optimizeTours نشان می دهد که مقادیر تنظیم شده در سناریوی مثال را در خود جای داده است:

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.8024,
              "longitude": -122.4058
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.759773,
              "longitude": -122.427063
            }
          }
        ]
        "penaltyCost": 40
      }
    ],
    "vehicles": [
      {
        "startLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "endLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "fixedCost": 30,
        "costPerKilometer": 0.08,
        "costPerHour": 27,
        "costPerTraveledHour": 2.5
      }
    ]
  }
}

ویژگی های پاسخگویی

پیام OptimizeToursResponse دارای ویژگی های هزینه ای است که هزینه های انجام شده در فرآیند تکمیل یک مسیر را توصیف می کند:

  • metrics.costs : هزینه کل در تمام مسیرها بر اساس فیلدهای درخواست مربوط به هزینه تفکیک شده است.
  • metrics.totalCost : مجموع هزینه تمام مسیرها خلاصه می شود.