খরচ মডেল

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

রুট অপ্টিমাইজেশন 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
      }
    ]
  }
}

উদাহরণ দৃশ্যকল্প

এই অংশে এমন একটি পরিস্থিতি বর্ণনা করা হয়েছে যেখানে আপনার একটি ডগি ডে-কেয়ার ব্যবসা আছে। আপনি যে ট্রাকটি ব্যবহার করে কুকুরগুলিকে তাদের বাড়ি থেকে তুলে নেওয়ার জন্য ব্যবহার করেন তার জন্য একটি রুট অপ্টিমাইজ করছেন। এই পরিস্থিতিতে, আপনি চান যে অপ্টিমাইজার একটি রুট প্রদান করার সময় কুকুরগুলিকে তুলে নেওয়ার খরচ এবং যানবাহন পরিচালনার খরচ বিবেচনা করুক।

এই উদাহরণের জন্য, একটি খরচ ইউনিট হল ১ ডলার। এর অর্থ হল আপনার অনুরোধে খরচ মডেলের বৈশিষ্ট্যের মানগুলি নিম্নরূপ:

সম্পত্তি মূল্য দৃশ্যকল্প
penaltyCost ১০ নির্ধারিত দিনে কুকুর না তোলার জন্য আপনার গ্রাহকদের যে জরিমানা দেওয়া হয়েছে তা এটি প্রতিনিধিত্ব করে। যখনই আপনি নির্ধারিত দিনে কুকুর না তোলেন, তখন গ্রাহক তাদের মোট পরিষেবা থেকে ৪০ ডলার ছাড় পাবেন।
fixedCost ৩০ আপনার যানবাহন ঋণ পরিশোধের দৈনিক খরচ প্রতিনিধিত্ব করে, যা প্রতিদিন 30 ডলার।
costPerKilometer ০.০৮ আপনার গাড়ি প্রতি কিলোমিটারে কত পেট্রোল খরচ করে তা নির্দেশ করে। আপনার গাড়ির চলাচলের জন্য প্রতি কিলোমিটারে ০.০৪ গ্যালন প্রয়োজন, এবং আপনার অঞ্চলে প্রতি গ্যালনের খরচ ২ ডলার।
costPerHour ২৭ আপনার গাড়ি চালানোর জন্য আপনি একজন ড্রাইভারকে কত টাকা দেন তা প্রতিনিধিত্ব করে। আপনি প্রতি ঘন্টায় ড্রাইভারকে ২৭ ডলার দেন।
costPerTraveledHour ২.৫ রাস্তায় কুকুরের জন্য গাড়ির এয়ার কন্ডিশনিংয়ের জন্য আপনাকে প্রতি ঘন্টায় কত টাকা দিতে হবে তা প্রতিনিধিত্ব করে। যখনই গাড়িটি চলমান থাকে না, তখন চালক পিছনের দরজা খুলে এয়ার কন্ডিশনিং বন্ধ করতে পারেন।

খরচের পরামিতিগুলির উপর ভিত্তি করে, অপ্টিমাইজার এমন ট্রেড-অফ করতে পারে যা ব্যবহারকারীর কাছে স্পষ্ট নয়, তবে অপ্টিমাইজেশনের মাধ্যমে পাওয়া যেতে পারে।

নিচের চিত্রটি এমন একটি উদাহরণ দেখায় যেখানে অপ্টিমাইজার সবুজ ড্যাশযুক্ত লাইনের মধ্য দিয়ে একটি দীর্ঘ কিন্তু দ্রুততর রুট বেছে নিতে পারে যাতে ডটেড লাল লাইনে ট্র্যাফিক এড়ানো যায়।

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 : সমস্ত রুটের মোট খরচের সারসংক্ষেপ।