আপনার Route Optimization API রেসপন্স ব্যাখ্যা করুন... কুকুরের সাথে

আপনার প্রথম অনুরোধ করুন বিকল্পে গিয়ে অনুরোধ পাঠানোর পরে, অপ্টিমাইজার OptimizeToursResponse রিটার্ন করে। এই উত্তরটি হল আপনার ড্রাইভারের অনুসরণ করার জন্য রুটের প্ল্যান। এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে কীভাবে এটি পড়তে হয়।

রুট প্ল্যানের সারসংক্ষেপ

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

• ডে-কেয়ার সেন্টারে সকাল ৭:৫৫-এ শিফ্ট শুরু করুন।
• সকাল ৮:২০-তে Coit Tower-এর কাছে বার্নিস মাউন্টেন ডগ পিক-আপ করো।
• সকাল ৮:৫৮-এ সাউথ সানসেট প্লেগ্রাউন্ড পার্ক থেকে চিহুয়াহুয়াকে তুলে নিন।
• সকাল ৯:২৪-এ ডে-কেয়ার সেন্টারে ফিরে আসুন এবং সকাল ৯:৩০-এ ড্রপ-অফ উইন্ডো খোলা পর্যন্ত অপেক্ষা করুন।
• সকাল ৯টা ৩০ মিনিটে বার্নিজ মাউন্টেন কুকুরকে নামিয়ে দিতে হবে।
• সকাল ৯:৩৫-এ চিহুয়াহুয়াকে নামিয়ে দাও।
• সকাল ৯:৪০-এ শিফ্ট শেষ করুন।

রুট প্ল্যানের খরচ $১৪৭.২২, যার মধ্যে জার্মান শেফার্ডকে এড়িয়ে যাওয়ার জন্য $১০০ জরিমানা অন্তর্ভুক্ত।

আপনার ফলাফল চেক করতে, সম্পূর্ণ উদাহরণের উত্তরের সাথে আপনার উত্তর তুলনা করুন। আপনার ফলাফল কিছুটা আলাদা হতে পারে কারণ ভ্রমণের সময় ও দূরত্ব বর্তমান রাস্তার ডেটার উপর নির্ভর করে।

{
  "routes": [
    {
      "vehicleStartTime": "2024-02-13T15:55:04Z",
      "vehicleEndTime": "2024-02-13T17:40:00Z",
      "visits": [
        {
          "isPickup": true,
          "startTime": "2024-02-13T16:20:00Z",
          "detour": "0s",
          "shipmentLabel": "Bernese mountain dog",
          "visitType": "PICKUP_SHIPMENT"
        },
        {
          "shipmentIndex": 1,
          "isPickup": true,
          "startTime": "2024-02-13T16:58:12Z",
          "detour": "2600s",
          "shipmentLabel": "Chihuahua",
          "visitType": "PICKUP_SHIPMENT"
        },
        {
          "startTime": "2024-02-13T17:30:00Z",
          "detour": "2297s",
          "shipmentLabel": "Bernese mountain dog",
          "visitType": "DELIVER_SHIPMENT"
        },
        {
          "shipmentIndex": 1,
          "startTime": "2024-02-13T17:35:00Z",
          "detour": "656s",
          "shipmentLabel": "Chihuahua",
          "visitType": "DELIVER_SHIPMENT"
        }
      ],
      "transitions": [
        {
          "travelDuration": "1496s",
          "travelDistanceMeters": 7082,
          "waitDuration": "0s",
          "totalDuration": "1496s",
          "startTime": "2024-02-13T15:55:04Z"
        },
        {
          "travelDuration": "1992s",
          "travelDistanceMeters": 16589,
          "waitDuration": "0s",
          "totalDuration": "1992s",
          "startTime": "2024-02-13T16:25:00Z"
        },
        {
          "travelDuration": "1252s",
          "travelDistanceMeters": 7860,
          "waitDuration": "356s",
          "totalDuration": "1608s",
          "startTime": "2024-02-13T17:03:12Z"
        },
        {
          "travelDuration": "0s",
          "waitDuration": "0s",
          "totalDuration": "0s",
          "startTime": "2024-02-13T17:35:00Z"
        },
        {
          "travelDuration": "0s",
          "waitDuration": "0s",
          "totalDuration": "0s",
          "startTime": "2024-02-13T17:40:00Z"
        }
      ],
      "metrics": {
        "performedShipmentCount": 2,
        "travelDuration": "4740s",
        "waitDuration": "356s",
        "delayDuration": "0s",
        "breakDuration": "0s",
        "visitDuration": "1200s",
        "totalDuration": "6296s",
        "travelDistanceMeters": 31531,
        "performedShipmentPenaltyCostSum": 2000
      },
      "routeCosts": {
        "model.vehicles.cost_per_hour": 47.22
      },
      "routeTotalCost": 47.22,
      "vehicleFullness": {
        "maxFullness": 0.3497777777777778,
        "activeSpan": 0.3497777777777778
      }
    }
  ],
  "skippedShipments": [
    {
      "index": 2,
      "label": "German shepherd",
      "penaltyCost": 100
    }
  ],
  "metrics": {
    "aggregatedRouteMetrics": {
      "performedShipmentCount": 2,
      "travelDuration": "4740s",
      "waitDuration": "356s",
      "delayDuration": "0s",
      "breakDuration": "0s",
      "visitDuration": "1200s",
      "totalDuration": "6296s",
      "travelDistanceMeters": 31531,
      "performedShipmentPenaltyCostSum": 2000
    },
    "usedVehicleCount": 1,
    "earliestVehicleStartTime": "2024-02-13T15:55:04Z",
    "latestVehicleEndTime": "2024-02-13T17:40:00Z",
    "totalCost": 147.22,
    "costs": {
      "model.vehicles.cost_per_hour": 47.22,
      "model.shipments.penalty_cost": 100
    }
  }
}
    

উত্তরের স্ট্রাকচার

OptimizeToursResponse-এ দুটি প্রধান কম্পোনেন্ট আছে:

• routes: আপনার ফ্লিটের প্রতিটি গাড়ির রুট প্ল্যান, যার মধ্যে প্রতিটি পিক-আপ ও ডেলিভারির ক্রম ও সময় অন্তর্ভুক্ত। আপনার একটি ভ্যান আছে, তাই একটি রুট প্ল্যান আছে।
• metrics: মোট খরচ, সময় ও দূরত্ব সহ সম্পূর্ণ রুট প্ল্যানের সারসংক্ষেপ।

যেহেতু অপ্টিমাইজার জার্মান শেফার্ডকে এড়িয়ে যায়, তাই উত্তরে skippedShipments-ও অন্তর্ভুক্ত থাকে।

নিম্নলিখিত বিভাগগুলি আপনাকে দেখায় যে উত্তরে রুট প্ল্যান সারসংক্ষেপের প্রতিটি বিবরণ কোথায় পাবেন।

কোন গাড়ি কোন রুটে চলে?

অপ্টিমাইজার একটি রুট প্ল্যান (routes অ্যারে) তৈরি করে যা আপনার অনুরোধে vehicles-এর ক্রমের সাথে সম্পর্কিত।

vehicleIndex ফিল্ডটি প্রতিটি গাড়িকে তার জিরো-বেসড পজিশনের উপর ভিত্তি করে শনাক্ত করে, যা আপনার ভ্যানের জন্য 0। vehicleStartTime এবং vehicleEndTime ফিল্ড থেকে ড্রাইভার জানতে পারেন যে কখন তার শিফ্ট শুরু ও শেষ করতে হবে।

Route Optimization API, UTC-তে টাইমস্ট্যাম্প রিটার্ন করে, যা Z প্রত্যয় দ্বারা চিহ্নিত করা হয়, আপনার অনুরোধে অফসেট যাই হোক না কেন। সান ফ্রান্সিসকোর সময় জানতে, ৮ ঘণ্টা বিয়োগ করুন। আপনার ভ্যানের জন্য, শিফ্ট সকাল ৭টা ৫৫ মিনিট থেকে সকাল ৯টা ৪০ মিনিট পর্যন্ত চলে, যেমনটি নিম্নলিখিত কোড স্যাম্পেলে দেখানো হয়েছে।

{
"routes": [
    {
    // "vehicleIndex": 0, // Omitted in actual JSON response because it's 0
    "vehicleStartTime": "2024-02-13T15:55:04Z",
    "vehicleEndTime": "2024-02-13T17:40:00Z",
    ...
    }
  ]
  ...
}

পিক-আপ ও ড্রপ-অফ অর্ডার কী?

প্রতিটি রুটের মধ্যে, visits অ্যারেতে অ্যাসাইন করা গাড়ির জন্য প্রতিটি পিক-আপ এবং ডেলিভারি কালানুক্রমিক ক্রমে থাকে।

প্রতিটি ভিজিটের shipmentIndex হল আপনার অনুরোধে শিপমেন্টের জিরো-বেসড পজিশন: 0 হল বার্নিজ মাউন্টেন ডগ এবং 1 হল চিহুয়াহুয়া। shipmentLabel ফিল্ডে প্রতিটি শিপমেন্টের জন্য আপনার সেট করা লেবেল দেখানো হয়।

পিক-আপ ও ড্রপ-অফ (বা ডেলিভারি)-এর মধ্যে পার্থক্য করতে, আপনি visitType অথবা isPickup ফিল্ড চেক করতে পারেন:

• visitType: ভিজিট অ্যাকশন স্পষ্টভাবে সংজ্ঞায়িত করে।
  • পিক-আপ: visitType = "PICKUP_SHIPMENT"
  • ডেলিভারি: visitType = "DELIVER_SHIPMENT"
• isPickup: একটি বুলিয়ান হেল্পার ফিল্ড।
  • পিক-আপ: isPickup = true
  • ডেলিভারি: isPickup = false (JSON-এ বাদ দেওয়া হয়েছে)

ইভেন্টের সঠিক ক্রম এবং প্রতিটি লোকেশনে পৌঁছানোর প্রত্যাশিত সময় নির্ধারণ করতে, visits অ্যারে ক্রমানুসারে পড়ুন। নিম্নলিখিত সারণীতে shipmentIndex, isPickup বা visitType এবং startTime ফিল্ডের ক্রম ও ভ্যালুর উপর ভিত্তি করে রুট প্ল্যান অ্যাকশন দেখানো হয়েছে।

নিম্নলিখিত কোডের নমুনা থেকে বোঝা যায় যে কীভাবে উত্তর এই ক্রম প্রদান করে:

{
  "routes": [
    {
      "visits": [
        {
          // "shipmentIndex": 0, // Omitted in actual JSON response because it's 0
          "isPickup": true,
          "startTime": "2024-02-13T16:20:00Z",
          "shipmentLabel": "Bernese mountain dog",
          "visitType": "PICKUP_SHIPMENT"
        },
        {
          "shipmentIndex": 1,
          "isPickup": true,
          "startTime": "2024-02-13T16:58:12Z",
          "shipmentLabel": "Chihuahua",
          "visitType": "PICKUP_SHIPMENT"
        },
        {
          // "shipmentIndex": 0, // Omitted in actual JSON response because it's 0
          // "isPickup": false, // Omitted in actual JSON response because it's false
          "startTime": "2024-02-13T17:30:00Z",
          "shipmentLabel": "Bernese mountain dog",
          "visitType": "DELIVER_SHIPMENT"
        },
        {
          "shipmentIndex": 1,
          // "isPickup": false, // Omitted in actual JSON response because it's false
          "startTime": "2024-02-13T17:35:00Z",
          "shipmentLabel": "Chihuahua",
          "visitType": "DELIVER_SHIPMENT"
        }
      ]
    }
  ]
}

এছাড়াও, প্রতিটি ভিজিটে একটি visitRequestIndex থাকে, যা হল পিক-আপ বা ড্রপ-অফ বিকল্পের জিরো-বেসড পজিশন যা অপ্টিমাইজার শিপমেন্টের জন্য বেছে নিয়েছে। এই পরিস্থিতিতে প্রতিটি কুকুরের জন্য শুধুমাত্র একটি পিক-আপ বিকল্প এবং একটি ড্রপ-অফ বিকল্প রয়েছে, তাই visitRequestIndex সর্বদা 0 এবং উত্তরে এটি বাদ দেওয়া হয়েছে।

ভিজিটের মধ্যবর্তী সময়ে কী হয়?

প্রতিটি রুটের মধ্যে, transitions অ্যারে, ভিজিটের মধ্যে ভ্রমণের বিবরণ তালিকাভুক্ত করে। যদিও visits এবং transitions আলাদা তালিকা, সেগুলি সময়ের সাথে সাথে ইন্টারলিভ করে, যেমন:

1. transitions[0] (শুরু থেকে প্রথম ভিজিট পর্যন্ত ড্রাইভ করুন)
2. visits[0] (প্রথম ভিজিট)
3. transitions[1] (প্রথম ভিজিট থেকে দ্বিতীয় ভিজিটে ড্রাইভ করে যাওয়া)
4. visits[1] (দ্বিতীয়বার ভিজিট)
5. ...
6. visits[N-1] (শেষবার ভিজিট, যেখানে N হল মোট ভিজিটের সংখ্যা)
7. transitions[N] (শেষবার ভিজিট করা থেকে শেষ পর্যন্ত ড্রাইভ করুন)

আপনি দুটি অ্যারেতেই startTime ফিল্ড দেখে রুটের টাইমলাইন ফলো করতে পারবেন। ড্রাইভার যখন যাত্রা শুরু করেন তখন ট্রানজিশনের startTime হয় এবং ড্রাইভার যখন পিক-আপ বা ড্রপ-অফ শুরু করেন তখন ভিজিটের startTime হয়।

প্রতিটি ট্রানজিশন লোকেশনগুলির মধ্যে প্রত্যাশিত ড্রাইভিং সময় এবং দূরত্ব দেখায়। নিম্নলিখিত সারণীটি transitions এবং visits উভয় ফিল্ডকে ডগি ডে-কেয়ারের দৃশ্যের জন্য কালানুক্রমিক রুট অ্যাকশনে ম্যাপ করে।

নিচে দেওয়া কোডের স্যাম্পেল থেকে বোঝা যায় যে কীভাবে উত্তর transitions[0] এবং transitions[1]-এর জন্য এই সিকোয়েন্স প্রদান করে:

{
  "routes": [
    {
      "transitions": [
        {
          "travelDuration": "1496s",
          "travelDistanceMeters": 7082,
          "waitDuration": "0s",
          "totalDuration": "1496s",
          "startTime": "2024-02-13T15:55:04Z"
        },
        {
          "travelDuration": "1992s",
          "travelDistanceMeters": 16589,
          "waitDuration": "0s",
          "totalDuration": "1992s",
          "startTime": "2024-02-13T16:25:00Z"
        },
        ...
      ]
    }
  ]
}

রুটের জন্য কত খরচ হবে?

আপনার নির্দিষ্ট কোনও গাড়ির জন্য খরচ নাকি পুরো ফ্লিটের জন্য মোট খরচ প্রয়োজন তার উপর নির্ভর করে আপনি উত্তরে বেশ কয়েকটি ফিল্ড দেখতে পারেন।

নিচের সারণীতে এমন সব উপায়ের তালিকা দেওয়া হয়েছে যার মাধ্যমে আপনি রেসপন্সে খরচের তথ্য খুঁজে পেতে পারেন:

routeCosts এবং costs-এ উল্লেখ করা খরচ আপনার অনুরোধে উল্লেখ করা খরচের সীমাবদ্ধতা দেখায়। আরও তথ্যের জন্য, কস্ট মডেলের মূল ধারণা ডকুমেন্ট দেখুন।

কুকুরের ডে-কেয়ারের এই পরিস্থিতিতে, আপনি একটি শিপমেন্ট এড়িয়ে গেছেন বলে, প্রতিটি রুটের খরচ এবং মোট খরচ আলাদা। রুটের খরচে শুধুমাত্র সেই নির্দিষ্ট রুটের সাথে সম্পর্কিত খরচ (ড্রাইভারের মজুরি) অন্তর্ভুক্ত থাকে, যদিও মোট খরচে বাদ দেওয়া শিপমেন্টের জন্য জরিমানাও অন্তর্ভুক্ত থাকে। নিম্নলিখিত কোডের স্যাম্পেল থেকে জানতে পারবেন যে রেসপন্সে কোথায় এই ভ্যালুগুলি খুঁজে পাবেন:

{
  "routes": [
    {
      "vehicleStartTime": "2024-02-13T15:55:04Z",
      "vehicleEndTime": "2024-02-13T17:40:00Z",
      ...
      "routeCosts": {
        "model.vehicles.cost_per_hour": 47.22
      },
      "routeTotalCost": 47.22
    }
  ],
  "metrics": {
    "totalCost": 147.22,
    "costs": {
      "model.shipments.penalty_cost": 100,
      "model.vehicles.cost_per_hour": 47.22
    },
    ...
  }
}

রুটের প্ল্যান অনুযায়ী, ড্রাইভার সকাল ৭:৫৫ থেকে সকাল ৯:৪০ পর্যন্ত ভ্যান চালান, যা প্রায় ১ ঘণ্টা ৪৫ মিনিট (৬২৯৬ সেকেন্ড)। আপনার নির্ধারিত রেট $২৭ প্রতি ঘণ্টা হিসেবে, রুটের খরচ হল $৪৭.২২। কারণ অপ্টিমাইজার জার্মান শেফার্ডের শিপমেন্ট এড়িয়ে গেছে, এটি $১০০ পেনাল্টি খরচ যোগ করে, মোট খরচ $১৪৭.২২ করে।

কেন কোনও শিপমেন্ট এড়িয়ে যাওয়া হয়েছে?

অপ্টিমাইজার এমন যেকোনও শিপমেন্টের তালিকা তৈরি করে যা skippedShipments অ্যারেতে পারফর্ম করে না। এটি কেন কোনও শিপমেন্ট এড়িয়ে যায় তা নির্ভর করে আপনি penaltyCost সেট করেছেন কিনা তার উপর:

• বাধ্যতামূলক শিপমেন্ট (penaltyCostটি): অপ্টিমাইজার কখনই এগুলি এড়িয়ে যায় না কারণ এগুলি করতে অনেক খরচ হয়। এটি শুধুমাত্র তখনই একটি শিপমেন্ট এড়িয়ে যায় যখন এটি কোনও রুটে শিপমেন্ট ফিট করতে পারে না, উদাহরণস্বরূপ, কারণ এর টাইম উইন্ডো অন্যান্য শিপমেন্টের সাথে কনফ্লিক্ট করে।
• ঐচ্ছিক শিপমেন্ট (penaltyCost সহ): অপ্টিমাইজার এগুলিও এড়িয়ে যেতে পারে যখন এগুলি করার খরচ জরিমানার চেয়ে বেশি হয়। আপনি কিছু শিপমেন্টকে অন্যদের চেয়ে অগ্রাধিকার দিতে বিভিন্ন পেনাল্টি খরচ সেট করতে পারেন।

এই পরিস্থিতিতে, জার্মান শেফার্ডের পিক-আপ উইন্ডো বার্নিজ মাউন্টেন ডগের উইন্ডোর সাথে ওভারল্যাপ করছে। কয়েট টাওয়ার ও ল্যান্ডস এন্ডের মধ্যে দূরত্ব ২৫ মিনিটের, তাই ড্রাইভার ২০ মিনিটের মধ্যে দুটি পিক-আপ করতে পারবেন না। অপ্টিমাইজারকে অবশ্যই একটি এড়িয়ে যেতে হবে। যেহেতু জার্মান শেফার্ডের ক্ষেত্রে পেনাল্টি খরচ কম (নিয়মিত ক্লায়েন্টের $১,০০০-এর তুলনায় $১০০), তাই অপ্টিমাইজার এটি এড়িয়ে যায় এবং $১০০ পেনাল্টি খরচ বহন করে।

নিম্নলিখিত কোডের নমুনা উত্তরে skippedShipments অবজেক্ট দেখায়:

{
  ...
  "skippedShipments": [
    {
      "index": 2,
      "label": "German shepherd",
      "penaltyCost": 100
    }
  ],
  ...
}

উত্তরে skippedShipments অবজেক্টে নিম্নলিখিত ফিল্ডগুলি থাকে:

• index: আপনার অনুরোধে শিপমেন্টের জিরো-বেসড ইন্ডেক্স (তৃতীয় শিপমেন্টের জন্য ২)।
• label: অনুরোধে আপনার উল্লেখ করা লেবেল ("জার্মান শেফার্ড")।
• penaltyCost: অনুরোধে আপনার উল্লেখ করা পেনাল্টি খরচ, যা API মোট খরচের সাথে যোগ করে।

অপ্টিমাইজার যাতে কোনও শিপমেন্ট এড়িয়ে না যায়, তার জন্য যে সীমাবদ্ধতার কারণে সমস্যা হচ্ছে সেটি শিথিল করুন। যেমন, জার্মান শেফার্ডের মালিককে আরও নমনীয় পিক-আপ উইন্ডোর জন্য জিজ্ঞাসা করুন এবং তারপরে আপনার অনুরোধে সেই পিক-আপের জন্য timeWindows আপডেট করুন।

উদা্হরণে উত্তর যোগ করার ফিল্ড

নিম্নলিখিত সারণীতে উদাহরণস্বরূপ পরিস্থিতিতে OptimizeToursResponse-এ ফেরত আসা সমস্ত উত্তর ফিল্ডের বর্ণনা দেওয়া হয়েছে। রুট প্ল্যান বোঝার জন্য আপনাকে প্রতিটি ফিল্ড ব্যবহার করতে হবে না, তবে আপনার ব্যবসার প্রয়োজন অনুসারে OptimizeToursRequest কীভাবে অ্যাডজাস্ট করবেন তা নির্ধারণ করতে আপনি এই ফিল্ডগুলি বিশ্লেষণ করতে পারেন। আরও তথ্যের জন্য, রুট প্ল্যান লাইফসাইকেল দেখুন।

আপনি পেরেন্ট বা টেক্সট সার্চের মাধ্যমে কন্টেন্ট ফিল্টার করতে পারবেন।