বড় গাড়ির রুট ও ETA জেনারেট করুন

এই নির্দেশিকা কাদের জন্য: আপনি যদি ট্রাক বা অন্যান্য বড় গাড়ি ব্যবহার করে ট্রিপ প্ল্যানিং এবং এক্সিকিউশনের জন্য পরিষেবা তৈরি করেন, তাহলে এই নির্দেশিকা পড়ুন। প্রাসঙ্গিক ব্যবহারের ক্ষেত্রে ভ্রমণের সময় এবং দূরত্ব গণনা করা, ETA গণনা করা বা নেভিগেশন অ্যাপ্লিকেশন দ্বারা ব্যবহার করা হবে এমন রুট তৈরি করা অন্তর্ভুক্ত।

এই গাইডে কী কী কভার করা হয়েছে: এই গাইডে কভার করা হয়েছে কীভাবে Routes API-এর সাথে Large Vehicle Routing ব্যবহার করে রুট, ভ্রমণের দূরত্ব, ভ্রমণের আনুমানিক সময় এবং ETA-এর জন্য অনুরোধ করা যায়, যা কমার্শিয়াল ট্রাক বা যাত্রীবাহী বাসের মতো বড় গাড়ির নির্দিষ্ট অ্যাট্রিবিউট বিবেচনা করে।

Route Optimization API ব্যবহার করে বড় গাড়ির জন্য কীভাবে ফ্লিট-লেভেল কম্পিউটেশন করতে হয় সেই সম্পর্কে তথ্য পেতে, Route Optimization ট্রাকের রুট সংক্রান্ত ডকুমেন্টেশন দেখুন।

আপনি কী শিখবেন

আপনি নিম্নলিখিত কাজগুলি কীভাবে করতে হয় তা শিখবেন:

• একটি সঠিক রাউটিং অনুরোধ তৈরি করুন।
• আপনার বাস্তব-জগতের গাড়ির জন্য গাড়ির তথ্য নির্দিষ্ট করুন, মাত্রা, ওজন এবং অন্যান্য বৈশিষ্ট্য ব্যবহার করে।
• রুট টোকেন ও ভ্রমণ নিরাপত্তা ফ্ল্যাগ সহ উত্তর ব্যাখ্যা করুন।

পূর্বশর্ত

1. আপনার Google Cloud প্রোজেক্ট তৈরি করতে হবে এবং Routes API চালু করতে হবে।
2. আপনার প্রোজেক্টে বড় গাড়ির জন্য রুট সংক্রান্ত তথ্য থাকতে হবে। বড় গাড়ির রুট সংক্রান্ত তথ্য সীমিত সংখ্যক গ্রাহকের জন্য উপলভ্য, অ্যাক্সেসের অনুরোধ করতে আমাদের সাথে যোগাযোগ করুন

সীমাবদ্ধতা

শুরু করার আগে, আপনাকে অবশ্যই নিম্নলিখিত সীমাবদ্ধতা এবং প্রয়োজনীয়তা সম্পর্কে সচেতন হতে হবে।

• ভৌগোলিক উপলভ্যতা: বড় গাড়ির জন্য রুট দেখানোর সুবিধা মার্কিন যুক্তরাষ্ট্রের ৪৮টি সংলগ্ন রাজ্য (সাধারণত উপলভ্য) এবং জাপানে (পরীক্ষামূলক) উপলভ্য। এটি আলাস্কা, হাওয়াই বা মার্কিন যুক্তরাষ্ট্রের অঞ্চলগুলিতে উপলভ্য নয়।
• ড্রাইভারের জন্য পরামর্শ ও নিরাপত্তা। নিরাপদ বা আইনিভাবে সঠিক হওয়ার জন্য ড্রাইভারদের শুধুমাত্র এই API-এর মাধ্যমে পাওয়া রুটের উপর নির্ভর করলে চলবে না। গাড়ির জন্য রুট উপযুক্ত হবে কিনা তার কোনও গ্যারান্টি নেই এবং সেগুলি অনুসরণ করলে ড্রাইভাররা নিচু ব্রিজ বা বড় গাড়ি নিষিদ্ধ এমন রাস্তার মতো বিপদের সম্মুখীন হতে পারেন।
• বেস্ট-এফর্ট রুট। কিছু ক্ষেত্রে, API এমন কোনও রুট খুঁজে পায় না যা ভ্রমণ সংক্রান্ত বিধিনিষেধ সম্পূর্ণভাবে মেনে চলে। পরিবর্তে, এটি "সেরা প্রচেষ্টা" রুট দেখায় যা এখনও সীমাবদ্ধ এলাকা অতিক্রম করতে পারে। Routes API রেসপন্স routeRestrictionsPartiallyIgnored ফিল্ডে এইসব রুট স্পষ্টভাবে ফ্ল্যাগ করে। এইসব ক্ষেত্রে, আপনার রুট সাবধানে প্ল্যান করুন, আদর্শগতভাবে অন্যান্য সোর্স ডেটা ব্যবহার করুন। প্ল্যানিং বা নেভিগেশনের জন্য single source of truth হিসেবে ফ্ল্যাগ করা রুট ব্যবহার করবেন না।
• কাজ করে না এমন ফিচার: বড় গাড়ির জন্য রুট দেখানোর সময় নিম্নলিখিত ফিচার কাজ করে না:
  • ট্রাকের টোল ট্যাক্স
  • স্পিড লিমিট
  • তেজস্ক্রিয় বিপজ্জনক মেটেরিয়ালের জন্য রাউটিং
• ব্যবহারের সীমা: সব অনুরোধ স্ট্যান্ডার্ড কোয়েরি-প্রতি-সেকেন্ড (QPS) সীমা অনুযায়ী হয়।

ট্রাক রুট সংক্রান্ত অনুরোধ তৈরি করুন

ট্রাকের রুট পেতে, আপনি Routes API এন্ডপয়েন্টে HTTPS অনুরোধ পাঠান, যেখানে আপনার গাড়ির বিবরণ সহ নির্দিষ্ট প্যারামিটার থাকে। এই বিভাগে উল্লেখ করা ধারণা সিঙ্গেল রুট ও রুট ম্যাট্রিক্স, দুই ধরনের অনুরোধের ক্ষেত্রেই প্রযোজ্য।

এন্ডপয়েন্ট

ট্রাক রুটিংয়ের জন্য আপনি দুটি এন্ডপয়েন্ট ব্যবহার করতে পারবেন:

• computeRoutes: একটি উৎস এবং একটি গন্তব্যের মধ্যে একটি রুট গণনা করে।
• computeRouteMatrix: উৎস ও গন্তব্যের ম্যাট্রিক্সের জন্য দূরত্ব ও সময়সীমা গণনা করে, তবে রুট পলিলাইন দেখায় না।

মূল অনুরোধের প্যারামিটার

ট্রাক রাউটিং চালু করতে আপনার অনুরোধের বডিতে নিম্নলিখিত প্যারামিটারগুলি অন্তর্ভুক্ত করতে হবে:

• travelMode: এই ভ্যালু TRUCK-এ সেট করুন।
• routingPreference: এই ভ্যালু TRAFFIC_AWARE_OPTIMAL-এ সেট করুন।
• routeModifiers: এই অবজেক্টে vehicleInfo অবজেক্ট থাকে যেখানে আপনি নিজের গাড়ির অ্যাট্রিবিউট নির্ধারণ করেন। vehicleInfo অবজেক্টের বিবরণ নিচে বিস্তারিতভাবে দেওয়া হল।

গাড়ির অ্যাট্রিবিউট নির্দিষ্ট করুন

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

গাড়ির পরিমাপ

গাড়ির ওজন কিলোগ্রামে এবং গাড়ির মাপ মিলিমিটারে দিন, যেমন ফিল্ডের নামে উল্লেখ করা আছে। যেমন, মোট উচ্চতা মিলিমিটারে (totalHeightMm) দিতে হবে। যেহেতু ট্রাকের ডাইমেনশন প্রায়ই ফুট বা মিটারে প্রকাশ করা হয়, তাই এটি কনভার্ট করার প্রয়োজন হতে পারে।

ইম্পেরিয়াল থেকে মেট্রিক ইউনিটে কনভার্ট করা

ইম্পেরিয়াল ইউনিট থেকে কনভার্ট করার সময়, সবসময় আপনার নির্দিষ্ট গাড়ির ডাইমেনশন এবং স্ট্যান্ডার্ড রাস্তা ও আন্ডারপাসের সাইজের সীমা বিবেচনা করুন। এটি বিশেষ করে ভগ্নাংশ ভ্যালুর ক্ষেত্রে গুরুত্বপূর্ণ হতে পারে। গাড়ির আসল সাইজের উপর নির্ভর করে, ভগ্নাংশ মান রাউন্ড আপ করলে, গাড়ির জন্য অত্যন্ত সীমাবদ্ধ রুট তৈরি হতে পারে।

যেমন:

• প্রস্থ: মার্কিন যুক্তরাষ্ট্রের অনেক ট্রেলারের প্রস্থ ৮' ৬", যা কনভার্ট করলে ২,৫৯০.৮ মিমি হয়। ২,৫৯১ মিমি পর্যন্ত রাউন্ড আপ করলে বোঝা যাবে যে গাড়িটি ৮ ফুট ৬ ইঞ্চির চেয়ে বড়, যা মার্কিন যুক্তরাষ্ট্রের রাস্তায় এটিকে একটি অতিরিক্ত আকারের গাড়ি হিসাবে শ্রেণীবদ্ধ করবে। এর ফলে, এমন একটি রুট গণনা করা হবে যা উদ্দেশ্য থেকে অর্থপূর্ণভাবে আলাদা সীমাবদ্ধতা অনুযায়ী গণনা করা হয়েছে।
• উচ্চতা: ১১ ফুট উচ্চতার ব্রিজের নিচ দিয়ে যাওয়া কোনও রুট ১৩.৫ ফুট উচ্চতার সাধারণ ট্রাক্টর-ট্রেলারের জন্য উপযুক্ত হবে না। তবে, ১০ ফুটের মতো ছোট বক্স ট্রাক আন্ডারপাস দিয়ে যেতে পারবে। সেই অনুযায়ী, আপনার গাড়ির অ্যাট্রিবিউট সঠিকভাবে উল্লেখ করা গুরুত্বপূর্ণ।

নিচে একটি কোড স্নিপেট দেওয়া হল যা একটি উদাহরণ vehicleInfo অবজেক্ট দেখায়:

"vehicleInfo": {
      "totalAxleCount": 5,
      "totalHeightMm": 4114,
      "totalLengthMm": 21945,
      "totalWidthMm": 2590,
      "totalWeightKg": 32658,
      "trailerInfo": [{
        "lengthMm": 16154
      }

vehicleInfoটি অবজেক্ট ফিল্ড

নিচের সারণীতে সমস্ত গাড়ি এবং লোডের সংজ্ঞা দেখানো হয়েছে যা আপনি অনুরোধের সাথে পাঠাতে পারেন।

ফিল্ড মাস্ক ব্যবহার করা

সেরা ফলাফলের জন্য, আপনার অনুরোধে X-Goog-FieldMask হেডার অন্তর্ভুক্ত করুন যাতে উত্তরে আপনি ঠিক কোন ফিল্ডগুলি চান তা নির্দিষ্ট করা যায়। ফিল্ড মাস্ক লেটেন্সি কমায় এবং আপনি যাতে গুরুত্বপূর্ণ অ্যাডভাইজরি ফিল্ড পান তা নিশ্চিত করে। কমপক্ষে, ফিল্ড মাস্কে সবসময় routes.travelAdvisory.routeRestrictionsPartiallyIgnored অন্তর্ভুক্ত করুন, কারণ এটি নির্দেশ করে যে রুটে এক বা একাধিক বিধিনিষেধ আছে কিনা যা আপনার গাড়ির ক্ষেত্রে প্রযোজ্য।

Routes API-এর সাথে FieldMasks সম্পর্কে আরও জানতে, এই নিবন্ধ দেখুন।

টোল

টোল-ফ্রি রুট পছন্দ করতে, অনুরোধের routeModifiers প্রপার্টিতে avoidTolls উল্লেখ করুন। রুট মডিফায়ার সম্পর্কে আরও তথ্যের জন্য, এড়িয়ে যাওয়ার জন্য রুটের ফিচার নির্দিষ্ট করুন দেখুন।

avoidTolls উল্লেখ করলে, উত্তরে টোল-ফ্রি রুটের গ্যারেন্টি দেওয়া হয় না। কিছু ক্ষেত্রে, শুরু থেকে গন্তব্যে পৌঁছানোর জন্য টোল রাস্তা ব্যবহার করতে হয়। আপনার Routes API অনুরোধের ফিল্ডমাস্কে routes.warnings অন্তর্ভুক্ত করলে, টোল রাস্তা সহ রুটগুলি এই ফিল্ডের মধ্যে সেই অনুযায়ী অ্যানোটেট করা হবে।

অন্যান্য রাউটিং আচরণ

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

computeRoutes-এর মাধ্যমে একটি রুট গণনা করুন

computeRoutes এন্ডপয়েন্ট ব্যবহার করে একটি উৎস ও একটি গন্তব্যের মধ্যে ট্রাকের জন্য নির্দিষ্ট রুট গণনা করুন।

computeRoutes-এর অনুরোধের উদাহরণ

সাধারণ সেমি-ট্রেলার ট্রাকের জন্য সম্পূর্ণ curl অনুরোধ এখানে দেওয়া হল। এই উদাহরণে এন্ডপয়েন্ট, হেডার ও অনুরোধের মূল অংশ অন্তর্ভুক্ত আছে।

curl --location 'https://routes.googleapis.com/directions/v2:computeRoutes' \
--header 'Content-Type: application/json' \
--header 'X-Goog-Api-Key: YOUR_API_KEY' \
--header 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeToken,routes.travelAdvisory.routeRestrictionsPartiallyIgnored' \
--data '{
 "origin": {
    "location": {
      "latLng": {
        "latitude": 40.883274,
        "longitude": -74.704574
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 40.991920,
        "longitude": -75.183371
      }
    }
  },
  "travelMode": "TRUCK",
  "routingPreference": "TRAFFIC_AWARE_OPTIMAL",
  "routeModifiers": {
    "vehicleInfo": {
      "totalAxleCount": 5,
      "totalHeightMm": 4114,
      "totalLengthMm": 21945,
      "totalWidthMm": 2590,
      "totalWeightKg": 32658,
      "trailerInfo": [{
        "lengthMm": 16154
      }]
    }
  }
}'

computeRoutes-এর উত্তরের উদাহরণ

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

{
  "routes": [
    {
      "distanceMeters": 3426,
      "duration": "312s",
      "travelAdvisory": {},
      "routeToken": "CogCCogBChA7b39q54cKGCys_VXaDADjEhgszp8YhZFw0xvzm7SygpvCeIvJ7V0r6XIaJZ6BxNkMa_8HhhqlAci7hYMXi6UCpPgDW-yoAf8gzgHiEYyJAnoiAQU6AQFCB27cD9UCwwdKCMX2Ij7RpxY_eAGqARdUNENZWllLS0tJRGZ2T01QMVptSjRBaxAEGmIKYBIWCAAQAxAGEBMQEhgCQgQaAggFSgIIASIbChdUNENZWmVTc0o0RGZ2T01QMVptSjRBa3ABKAQyJ3RydWNraW5nOjpzZW1pLXRyYWlsZXItdHJ1Y2staGVhdnktc29mdCIVAOzExFsGGGfjVIIY7GXjYbPyONS8EiQiInRydWNraW5nOjpzZW1pLXRyYWlsZXItdHJ1Y2staGVhdnk"
    }
  ]
}

computeRoutes-এর উত্তর ব্যাখ্যা করো

computeRoutes এন্ডপয়েন্টে করা অনুরোধ সফল হলে, এক বা একাধিক সম্ভাব্য রুট সহ JSON রেসপন্স অবজেক্ট পাওয়া যায়।

মূল উত্তর যোগ করার ফিল্ড

• এনকোড করা রুট জিওমেট্রি: routes.polyline. ম্যাপে রুট রেন্ডার করতে এটি ব্যবহার করা যেতে পারে।
• ট্রিপের আনুমানিক সময়সীমা: routes.duration (সেকেন্ডে)। বড় গাড়ির রুট ট্রিপের সময়কাল একটি নতুন মডেল ব্যবহার করে যা রাস্তার নেটওয়ার্কে প্রকৃত ট্রাকের পর্যবেক্ষণ করা ভ্রমণের গতির উপর প্রশিক্ষিত। এছাড়াও, এটি প্রত্যাশিত ছাড়ার নির্ধারিত সময়ের সাথে ট্রিপের আনুমানিক সময় যোগ করে ETA গণনা করতে ব্যবহার করা যেতে পারে।
• রুটের মোট দূরত্ব: routes.distanceMeters (মিটারে)।
• রুট টোকেন: routes.routeToken। এটি একটি অস্বচ্ছ টোকেন যা সঠিকভাবে গণনা করা রুট দেখায়। ড্রাইভারকে যাতে একই ট্রাক-নির্দিষ্ট রুট দেখানো হয় তা নিশ্চিত করতে আপনি এই টোকেনটি Navigation SDK-তে পাস করেন। আরও জানতে, Android বা iOS-এর জন্য Navigation SDK গাইড দেখুন।

রুটের নিরাপত্তা সংক্রান্ত ফ্ল্যাগ চেক করুন

আপনি কোনও উত্তর পেলে, প্রথমে আপনাকে রুট নিরাপত্তা ফ্ল্যাগ চেক করতে হবে। প্রদান করা রুটে এক বা একাধিক বিধিনিষেধ থাকলে, যা এটিকে গাড়ির জন্য অনুপযুক্ত করে তোলে, আপনি travelAdvisory.routeRestrictionsPartiallyIgnored ফিল্ডটি true-এ সেট করা দেখতে পাবেন।

এই ফিল্ডটি "এই রুটটি কি সম্ভাব্য সমস্যার জন্য ফ্ল্যাগ করা হয়েছে?" প্রশ্নের উত্তর দেওয়ার জন্য একটি ফ্ল্যাগ হিসেবে কাজ করে।

• false(অথবা উত্তর থেকে বাদ দেওয়া হয়েছে): রুটটি ফ্ল্যাগ করা হয়নি। সিস্টেম এমন একটি রুট খুঁজে পেয়েছে যা আপনার অনুরোধে উল্লেখ করা প্যারামিটার সম্পূর্ণভাবে মেনে চলে বলে মনে করা হচ্ছে।
• true: রুটটি ফ্ল্যাগ করা হয়েছে। সিস্টেমটি সম্পূর্ণভাবে উপযুক্ত রুট খুঁজে পায়নি এবং "সেরা প্রচেষ্টা" রুট দেখিয়েছে যা নিরাপদ বা আইনি নাও হতে পারে। এই রুটটি অত্যন্ত সতর্কতার সাথে ব্যবহার করতে হবে।

রুটের ম্যাট্রিক্স গণনা করুন (computeRouteMatrix)

computeRouteMatrix এন্ডপয়েন্ট ব্যবহার করে একাধিক উৎস ও গন্তব্যের মধ্যে ভ্রমণের সময় ও দূরত্ব দক্ষতার সাথে তুলনা করুন। যেমন, নতুন পিক-আপ লোকেশনের সবচেয়ে কাছে থাকা ট্রাক খুঁজে পেতে আপনি এটি ব্যবহার করতে পারেন। আপনার উদ্দেশ্যের জন্য যে গাড়ির উৎস ব্যবহার করতে চান সেটি শনাক্ত করার পরে, প্রস্তাবিত গাড়ির জন্য রুটের বিবরণ ও রুট টোকেন পেতে আপনি computeRoutes অনুরোধ করতে পারেন।

computeRouteMatrix ব্যবহার করতে, আপনি অনুরোধের রুটে নয়, বরং প্রতিটি origin অবজেক্টের মধ্যে vehicleInfo নির্দিষ্ট করেন।

computeRouteMatrix-এর অনুরোধের উদাহরণ

{
  "origins": [
    {
      "waypoint": { "location": { "latLng": { "latitude": 32.77, "longitude": -96.85 }}},
      "routeModifiers": { "vehicleInfo": { /* ...vehicle attributes... */ } }
    },
    {
      "waypoint": { "location": { "latLng": { "latitude": 33.61, "longitude": -112.11 }}},
      "routeModifiers": { "vehicleInfo": { /* ...vehicle attributes... */ } }
    }
  ],
  "destinations": [
    { "waypoint": { "location": { "latLng": { "latitude": 35.02, "longitude": -106.64 }}}},
    { "waypoint": { "location": { "latLng": { "latitude": 29.77, "longitude": -95.40 }}}}
  ],
  "travelMode": "TRUCK",
  "routingPreference": "TRAFFIC_AWARE_OPTIMAL"
}

computeRouteMatrix-এর উত্তরের উদাহরণ

উত্তরটি একটি অ্যারে যেখানে প্রতিটি অবজেক্টে একটি সোর্স-ডেস্টিনেশন পেয়ারের জন্য সময়সীমা এবং distanceMeters থাকে।

[
  {
    "originIndex": 0,
    "destinationIndex": 1,
    "status": {},
    "distanceMeters": 392372,
    "duration": "14037s",
    "condition": "ROUTE_EXISTS"
  },
  { ... }
]

পরবর্তী ধাপ

• ধাপে ধাপে নেভিগেশন প্রদান করা: Android বা iOS-এর জন্য নেভিগেশন SDK-তে routeToken কীভাবে ব্যবহার করবেন তা জানুন।
• ফ্লিট-লেভেল অপ্টিমাইজেশন পারফর্ম করুন: Route Optimization API with Large Vehicle Routing ব্যবহার করুন।
• API রেফারেন্স: সম্ভাব্য সব ফিল্ড ও ভ্যালুর সম্পূর্ণ তালিকা পেতে, Routes API রেফারেন্স দেখুন।