রুট কম্পিউট করা

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

এই পৃষ্ঠায় Pro বিকল্প সহ অনুরোধের বিকল্পগুলি বর্ণনা করা হয়েছে; উত্তরে কী কী থাকে; এবং অনুরোধের জন্য কীভাবে বিল করা হয়। টুলের সম্পূর্ণ স্কিমার জন্য, compute_routes রেফারেন্স দেখুন।

অনুরোধের বিকল্প

Option বিবরণ
origin, destination প্রয়োজনীয়। প্রতিটি হল একটি ওয়েপয়েন্ট: একটি address (মানুষের-পঠনযোগ্য ঠিকানা বা একটি Plus Code), একটি place_id বা একটি lat_lng। আপনি ফর্ম্যাট মিক্স করতে পারেন, যেমন, শুরুর জায়গার জন্য ঠিকানা এবং গন্তব্যের জন্য প্লেস আইডি।
travel_mode পরিবহনের মোড: DRIVE (ডিফল্ট), WALK, BICYCLE অথবা TRANSIT। WALK রুট বিটা ভার্সনে আছে এবং কখনও কখনও ফুটপাথ বা পথচারীদের জন্য রাস্তা নাও থাকতে পারে। আপনার অ্যাপে দেখানো সব হাঁটার রুটের জন্য ব্যবহারকারীকে এই সতর্কতা দেখাতে হবে।
routing_preference রুট গণনা করার জন্য ট্রাফিক ডেটা কীভাবে ব্যবহার করা হয়: ROUTING_PREFERENCE_TRAFFIC_UNAWARE (ডিফল্ট) বা ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, যা একটি প্রো বিকল্প। WALK বা BICYCLE-এর জন্য ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL কাজ করে না। ট্রাফিক-অ্যাওয়ার রাউটিং দেখুন।
intermediate_waypoints যাত্রা শুরুর স্থান ও গন্তব্যের মধ্যে স্টপের ক্রম। রুটটি প্রদত্ত ক্রমে তাদের মধ্য দিয়ে যায়। একটি অনুরোধে সর্বাধিক ১০টি মধ্যবর্তী ওয়েপয়েন্ট অন্তর্ভুক্ত করা যেতে পারে, অথবা Pro বিকল্প হিসেবে ১১ থেকে ২৫টি। ২৫টির বেশি অনুরোধ করলে INVALID_ARGUMENT সমস্যা দেখা দেয়। ট্রানজিট রুটে মধ্যবর্তী ওয়েপয়েন্ট কাজ করে না।
departure_time বা arrival_time RFC 3339 টাইমস্ট্যাম্প অনুযায়ী, কখন উৎস থেকে রওনা হতে হবে বা গন্তব্যে পৌঁছাতে হবে। সর্বাধিক একটি সেট করুন। ডিফল্ট হিসেবে বর্তমান সময়ে রওনা হওয়ার সময় সেট করা থাকে। TRANSIT-এর জন্য, সময়টি অতীতে সর্বাধিক ৭ দিন বা ভবিষ্যতে ১০০ দিন পর্যন্ত হতে পারে। অন্যান্য ভ্রমণ মোডের ক্ষেত্রে, সময়টি অতীতের হতে পারবে না এবং ৩৬৫ দিন পর্যন্ত ভবিষ্যতের হতে পারবে।
compute_alternative_routes true হলে, বিকল্প রুট উপলভ্য থাকলে, উত্তরে সাজেস্ট করা রুটের পাশাপাশি বিকল্প রুটও অন্তর্ভুক্ত থাকে। ডিফল্ট হিসেবে false সেট করা থাকে।
include_polyline true হলে, উত্তরে প্রতিটি রুটে encodedPolyline অন্তর্ভুক্ত থাকে। ডিফল্ট হিসেবে false সেট করা থাকে।
location_bias অক্ষাংশ ও দ্রাঘিমাংশ যা টেক্সট ওয়েপয়েন্ট কীভাবে সমাধান করা হবে তা প্রভাবিত করে, যেমন কোনও ঠিকানা দ্ব্যর্থহীন করা।

Pro বিকল্প

দুটি বিকল্প Pro SKU বেছে নেয়। যে অনুরোধে একটি বা দুটিই ব্যবহার করা হয়, সেটির বিল Pro SKU-এর অধীনে করা হয়:

প্রো বিকল্প কখন ব্যবহার করবেন
ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL এ routing_preference সেট করা হয়েছে ব্যবহারকারী ট্রাফিক, যানজট বা ভ্রমণের সময় সম্পর্কে জিজ্ঞাসা করেন যা বর্তমান ট্রাফিককে বিবেচনা করে। ট্রাফিক-অ্যাওয়ার রাউটিং দেখুন।
১১ থেকে ২৫ intermediate_waypoints যাত্রা শুরুর স্থান ও গন্তব্যের মধ্যে রুটে ১০টির বেশি স্টপ প্রয়োজন।

অন্যান্য সব বিকল্পের জন্য Essentials SKU-এর অধীনে বিল করা হয়, যার মধ্যে রয়েছে ভ্রমণের মোড, সময়, বিকল্প রুট, পলিলাইন ও লোকেশন বায়াস।

ট্রাফিক-অ্যাওয়ার রাউটিং

ডিফল্ট হিসেবে, লাইভ ট্রাফিক পরিস্থিতি ছাড়াই রুট গণনা করা হয় (ROUTING_PREFERENCE_TRAFFIC_UNAWARE)। এই সেটিংয়ে লেটেন্সি সবচেয়ে কম হয়। এটি এমন অনুরোধের জন্য উপযুক্ত যেখানে ট্রাফিক গুরুত্বপূর্ণ নয় বা প্রযোজ্য নয়, যেমন হাঁটার রুট বা রাফ প্ল্যানিং।

ট্রাফিক ডেটা উপলভ্য থাকলে, বর্তমান ট্রাফিক পরিস্থিতি অনুযায়ী রুট ও তার সময়সীমা গণনা করতে, routing_preference-কে ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL-এ সেট করুন। ব্যবহারকারী যখন জানতে চান যে ড্রাইভ করতে কতক্ষণ সময় লাগবে, তখন এটি ব্যবহার করুন। TRANSIT রুটের জন্য, এই সেটিং রিয়েল-টাইম ট্রানজিট ডেটা ব্যবহার করে, যেমন উপলভ্য থাকলে, দেরি এবং বাতিল হওয়া। এটি WALK বা BICYCLE রুটের জন্য কাজ করে না; এইসব অনুরোধের ক্ষেত্রে INVALID_ARGUMENT সমস্যা দেখা যায়। এটি একটি Pro বিকল্প, তাই অনুরোধটি Pro SKU-এর অধীনে বিল করা হয়। এই বিকল্পটি লেটেন্সিও যোগ করে।

সীমাবদ্ধ GA চলাকালীন, আপনার প্রোজেক্ট Pro অনুমোদিত তালিকায় না থাকলে, এই বিকল্পটি ROUTING_PREFERENCE_TRAFFIC_UNAWARE হিসেবে বিবেচিত হয়। আরও জানতে, সীমাবদ্ধ GA চলাকালীন প্রো বিকল্প দেখুন।

উদাহরণ

নিম্নলিখিত অনুরোধে একটি ইন্টারমিডিয়েট স্টপ ও এনকোড করা পলিলাইন সহ ট্রাফিক-অ্যাওয়ার ড্রাইভিং রুটের জন্য অনুরোধ করা হয়েছে। এটি Pro SKU-এর অধীনে বিল করা হয়:

{
  "method": "tools/call",
  "params": {
    "name": "compute_routes",
    "arguments": {
      "origin": {"address": "Ferry Building, San Francisco, CA"},
      "destination": {"address": "Golden Gate Park, San Francisco, CA"},
      "intermediate_waypoints": [
        {"address": "Palace of Fine Arts, San Francisco, CA"}
      ],
      "travel_mode": "DRIVE",
      "routing_preference": "ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL",
      "include_polyline": true
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

রেসপন্স

উত্তরে routes[]টি বিকল্প রয়েছে, যা সবচেয়ে বেশি থেকে সবচেয়ে কম সাজেস্ট করা বিকল্পের ক্রমে সাজানো হয়েছে। compute_alternative_routes, true না হলে, শুধুমাত্র একটি রুট দেখানো হয়। প্রতিটি রুটে এগুলি অন্তর্ভুক্ত:

  • distanceMeters: রুটের ভ্রমণের দূরত্ব, মিটারে।
  • duration: এই রুটে যেতে যতটা সময় লাগবে। ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL-এর মাধ্যমে, ট্রাফিক পরিস্থিতি অনুযায়ী সময়কাল হিসেব করা হয়।
  • encodedPolyline: রুটের পাথ এনকোড করা পলিলাইন হিসেবে, যখন include_polyline হল true। অন্যান্য Google Maps Platform API-এর সাথে ম্যাপে রুট আঁকার জন্য আপনি এটি ব্যবহার করতে পারবেন।
  • attribution: রুটের সাথে আপনাকে অবশ্যই অ্যাট্রিবিউশন দেখাতে হবে। অ্যাট্রিবিউশন সংক্রান্ত প্রয়োজনীয়তা দেখুন।

সীমাবদ্ধ GA চলাকালীন Pro বিকল্প

Restricted GA চলাকালীন, Pro বিকল্পগুলি শুধুমাত্র Pro অনুমোদিত তালিকায় থাকা প্রোজেক্টের জন্য উপলভ্য। আপনার প্রোজেক্ট এখনও সাদাতালিকায় না থাকলে:

  • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL-কে ROUTING_PREFERENCE_TRAFFIC_UNAWARE হিসেবে বিবেচনা করা হয় এবং অনুরোধটি Essentials SKU-এর অধীনে বিল করা হয়।
  • ১০টির বেশি ইন্টারমিডিয়েট ওয়েপয়েন্ট সহ অনুরোধ করা হলে, INVALID_ARGUMENT সমস্যা ("সর্বাধিক ১০টি ইন্টারমিডিয়েট ওয়েপয়েন্ট কাজ করে") দেখায়।

অ্যাক্সেসের অনুরোধ করতে, সীমাবদ্ধ GA চলাকালীন Pro বিকল্প দেখুন।

বিলিং ও কোটা

প্রতিটি compute_routes অনুরোধ হল একটি বিলেবল ইভেন্ট:

  • কোনও অনুরোধে Pro বিকল্প ব্যবহার না করা হলে, সেটির জন্য Essentials SKU-এর অধীনে বিল করা হয়।
  • Pro বিকল্প ব্যবহার করে করা অনুরোধ Pro SKU-এর অধীনে বিল করা হয়। একটি অনুরোধে দুটি Pro বিকল্প ব্যবহার করলে চার্জে কোনও পরিবর্তন হয় না। Pro-এর দাম জানতে, Essentials, Pro এবং Grounding with Google Maps-এর তুলনা করুন দেখুন।

বিকল্প রুট, পলিলাইন, রওনা হওয়া বা পৌঁছানোর সময় অথবা অন্য কোনও ট্রাভেল মোডের অনুরোধ করলে SKU পরিবর্তন হয় না।

compute_routes কোটা হল প্রতি মিনিটে, প্রতি প্রোজেক্টে ৩০০টি কোয়েরি, যা দুটি SKU-এর মাধ্যমে শেয়ার করা হয়। মূল্য সংক্রান্ত তথ্যের জন্য, মূল্য সংক্রান্ত প্রধান টেবিল এবং ভারতের জন্য মূল্য সংক্রান্ত টেবিল দেখুন।

সীমা

  • একটি অনুরোধে সর্বাধিক ২৫টি মধ্যবর্তী ওয়েপয়েন্ট অন্তর্ভুক্ত করা যেতে পারে; ১১ থেকে ২৫টি ওয়েপয়েন্ট Pro বিকল্পে অন্তর্ভুক্ত। আরও বেশি সহ অনুরোধ একটি INVALID_ARGUMENT সমস্যা দেখায়।
  • ট্রানজিট রুটে মধ্যবর্তী ওয়েপয়েন্ট কাজ করে না। ইন্টারমিডিয়েট ওয়েপয়েন্ট সহ ট্রানজিট অনুরোধের ক্ষেত্রে INVALID_ARGUMENT সমস্যা দেখা যায়।
  • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL হাঁটা বা সাইকেল চালানোর রুটের জন্য কাজ করে না।
  • ট্রানজিট রুটের ক্ষেত্রে, ছাড়ার ও পৌঁছানোর সময় সর্বাধিক ৭ দিন আগে বা ১০০ দিন পরে হতে পারে। অন্যান্য ট্রাভেল মোডের ক্ষেত্রে, সেগুলি অতীতের হতে পারে না এবং ৩৬৫ দিন পর্যন্ত হতে পারে।
  • ওয়েপয়েন্ট স্থানাঙ্ক অবশ্যই সঠিক ভৌগোলিক সীমার মধ্যে হতে হবে (অক্ষাংশ -৯০ থেকে ৯০, দ্রাঘিমাংশ -১৮০ থেকে ১৮০)।
  • টুলটি এক এক করে ধাপ, লেগ বা ট্রানজিট লাইনের বিবরণ প্রদান করে না।