Routes API হল দুটি পদ্ধতি সহ একটি ওয়েব পরিষেবা: Compute Routes ঐচ্ছিক মধ্যবর্তী ওয়েপয়েন্ট সহ দুটি লোকেশনের মধ্যে একটি রুট দেখায় এবং Compute Route Matrix উৎস এবং গন্তব্যের কম্বিনেশনের জন্য (৬২৫টি পর্যন্ত রুট এলিমেন্ট) ভ্রমণের দূরত্ব এবং সময় দেখায়।
Routes API: গুরুত্বপূর্ণ তথ্য
- প্রোডাক্ট: Routes API
- এছাড়াও, এই নামে পরিচিত: Routes API v2, Compute Routes, Compute Route Matrix
- বিভাগ: রুট
- প্ল্যাটফর্ম: ওয়েব পরিষেবা (REST)
- রান করে: সার্ভার (ব্যাকএন্ড কোড)
- লঞ্চ স্টেজ: GA
- লাইফসাইকেল: অ্যাক্টিভ
- এক নজরে: Routes API এক নজরে
- আঞ্চলিক উপলভ্যতা: বিশ্বব্যাপী। দু-চাকার গাড়ির রুট, ইকো-ফ্রেন্ডলি রুট ও টোল গণনা শুধুমাত্র কাজ করে এমন দেশ ও শহরেই সীমাবদ্ধ এবং নিজস্ব CLDR কোড সহ নির্ভরশীল অঞ্চলগুলি তালিকাভুক্ত না থাকলে কাজ করে না। ইউরোপীয় অর্থনৈতিক অঞ্চলের (EEA) বিলিং ঠিকানার জন্য, https://developers.google.com/maps/comms/eea/routes লিঙ্কে EEA শর্তাবলী অনুযায়ী, কোনও ম্যাপের সাথে রুটের বিবরণ বা ধাপ ব্যবহার করা নিষিদ্ধ। (কভারেজ সংক্রান্ত বিবরণ)
Routes API: কখন এটি ব্যবহার করবেন
Routes API ব্যবহার করুন যখন:
- গাড়ি চালানো, হাঁটা, সাইকেল চালানো, টু-হুইলার বা ট্রানজিটের জন্য, আপনার যাত্রা শুরু ও গন্তব্যের মধ্যে রুট প্রয়োজন, যেখানে ঐচ্ছিক মধ্যবর্তী ওয়েপয়েন্ট থাকতে পারে।
- একটি অনুরোধে (৬২৫টি এলিমেন্ট পর্যন্ত) অনেক উৎস-গন্তব্য জোড়ার জন্য আপনাকে ভ্রমণের দূরত্ব এবং সময় জানতে হবে।
- আপনার টোল ফি-এর আনুমানিক হিসেব (বেছে নেওয়া শহর), ইকো-ফ্রেন্ডলি রুট (বেছে নেওয়া অঞ্চল), ট্রাফিক-অ্যাওয়ার পলিলাইন বা বড় গাড়ির রুট (সীমিত উপলভ্যতা) প্রয়োজন।
- আপনি পুরনো Directions API বা Distance Matrix API থেকে সার্ভার অ্যাপ মাইগ্রেট করছেন।
এইসব ক্ষেত্রে Routes API ব্যবহার করবেন না:
- আপনাকে লোড অ্যাসাইনমেন্ট অপ্টিমাইজ করতে হবে এবং গাড়ির পুরো ফ্লিটের জন্য অর্ডার করা বন্ধ করতে হবে। পরিবর্তে Route Optimization API ব্যবহার করুন।
- Android-এ আপনার অ্যাপ-মধ্যস্থ ধাপে ধাপে নেভিগেশন প্রয়োজন যা গণনা করা রুট অনুসরণ করে। এর পরিবর্তে Android-এর জন্য Navigation SDK ব্যবহার করুন।
- iOS-এ আপনার ইন-অ্যাপ ধাপে ধাপে নেভিগেশন প্রয়োজন যা গণনা করা রুট অনুসরণ করে। পরিবর্তে iOS-এর জন্য Navigation SDK ব্যবহার করুন।
Routes API: সেট-আপ
- পরিষেবা চালু করতে:
routes.googleapis.com - যাচাইকরণ: API কী, OAuth 2.0, পরিষেবা অ্যাকাউন্ট
- শুরু করুন: Routes API সেট-আপ করুন
- রেফারেন্স: Routes API রেফারেন্স
- দাম: Routes API-এর ব্যবহার ও বিলিং
- নীতি: Routes API সংক্রান্ত নীতি
- রিলিজ নোট: Routes API রিলিজ নোট
অফিসিয়াল Routes API প্যাকেজ:
- npm:
@googlemaps/routing - pypi:
google-maps-routing - যান:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routing
Routes API: সম্পর্কিত প্রোডাক্ট
- পরিবর্তন করে: Directions API, Distance Matrix API
- সাধারণত যেগুলির সাথে ব্যবহার করা হয়: Android-এর জন্য Navigation SDK, iOS-এর জন্য Navigation SDK, Route Optimization API, Geocoding API, Places API (নতুন)
Routes API: সাধারণ ভুল
- সমস্যা: ফেরত আসা ফিল্ডের কোনও ডিফল্ট তালিকা নেই; ফিল্ড মাস্ক (
X-Goog-FieldMaskহেডার বা$fieldsপ্যারামিটার) ছাড়া অনুরোধ করলে সমস্যা দেখা দেয়। সমাধান: আপনার প্রয়োজনীয় রেসপন্স ফিল্ডের তালিকা সহ ফিল্ড মাস্ক সবসময় পাঠান। /maps/documentation/routes/choose_fields দেখুন। - সমস্যা: প্রোডাকশনে ওয়াইল্ডকার্ড ফিল্ড মাস্ক (
*) ব্যবহার করলে খরচ ও লেটেন্সি বেড়ে যায় এবং উত্তরে নতুন উন্নত ফিচার যোগ করার কারণে খরচ অপ্রত্যাশিতভাবে বেড়ে যেতে পারে। সমাধান: শুধুমাত্র ডেভেলপমেন্টের সময়*ব্যবহার করুন; প্রোডাকশনে শুধু আপনার প্রয়োজনীয় ফিল্ডের জন্য অনুরোধ করুন। /maps/documentation/routes/choose_fields দেখুন। - সমস্যা: ফিল্ড মাস্কে যোগ করলেই টোল সংক্রান্ত তথ্য এবং জ্বালানি খরচ সংক্রান্ত তথ্য পাওয়া যায় না; GA-এর কারণে এগুলি স্পষ্টভাবে চালু করতে হবে। সমাধান: ফিল্ড মাস্ক ছাড়াও অনুরোধে
extraComputationsঅ্যারে (যেমনTOLLS,FUEL_CONSUMPTION) যোগ করুন। /maps/documentation/routes/migrate-routes-preview দেখুন। - সমস্যা: Compute Route Matrix-এ ৬২৫টি এলিমেন্ট অনুমোদিত, তবে
routingPreference,TRAFFIC_AWARE_OPTIMALহলে মাত্র ১০০টি এলিমেন্ট অনুমোদিত। সমাধান:TRAFFIC_AWARE_OPTIMALব্যবহার করার সময় উৎস x গন্তব্য ১০০ বা তার কম রাখুন অথবা অনুরোধটি ভাগ করে নিন। /maps/documentation/routes/compute_route_matrix দেখুন।
Routes API-এর সাহায্যে আপনি কী কী করতে পারবেন
প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।
- কোনও রুটের প্রতিটি ধাপের জন্য স্থানাঙ্কের সিরিজ হিসেবে দুই বা তার বেশি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের মধ্যে দিকনির্দেশ দেখায়।
- একটি রুটের বিভিন্ন ধাপের জন্য ম্যানুভারের বিবরণের সিরিজ হিসেবে দুই বা তার বেশি সেট অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের মধ্যে দিকনির্দেশ দেখায়।
- অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের দুই বা তার বেশি সেটের মধ্যে কোনও রুটের প্রতিটি ধাপের মধ্যে দূরত্ব দেখায়।
- দুই বা তার বেশি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেটের মধ্যে কোনও রুটের প্রতিটি ধাপের মধ্যে ভ্রমণের সময় দেখায়।
- দুই বা তার বেশি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেটের মধ্যে রুটের প্রতিটি ধাপের মধ্যে একটি এনকোড করা পলিলাইন দেখায়।
- দুই বা তার বেশি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেটের মধ্যে কোনও রুটের দূরত্ব দেখায়।
- দুই বা তার বেশি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেটের মধ্যে কোনও রুটের জন্য ভ্রমণের সময় দেখায়।
- দুই বা তার বেশি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেটের মধ্যে রুটের জন্য এনকোড করা পলিলাইন রিটার্ন করুন।
- দুই বা তার বেশি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেটের মধ্যে কোনও রুটের টোল সংক্রান্ত তথ্য রিটার্ন করুন।
- রুট সংক্রান্ত অনুরোধের জন্য ভ্রমণের মোড (ড্রাইভ, ট্রানজিট, হাঁটা, দুই চাকা) উল্লেখ করুন। মনে রাখবেন: Routes API ওয়েব সার্ভিসে (computeRoutes), RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT, বা routeModifiers.vehicleInfo সহ TRUCK) ব্যবহার করে HTTP POST JSON বডিতে travelMode পাস করুন এবং পুরনো GET মোড কোয়েরি প্যারামিটারের পরিবর্তে প্রয়োজনীয় X-Goog-FieldMask হেডার অন্তর্ভুক্ত করুন। Maps JavaScript API Routes লাইব্রেরিতে, ComputeRoutesRequest-এ travelMode এবং ফিল্ড পাস করুন।
- রুট সংক্রান্ত অনুরোধের জন্য স্টপ বা পাস-থ্রু পয়েন্ট নির্দিষ্ট করুন।
- রুট সংক্রান্ত অনুরোধে ট্রাফিক ডেটা কীভাবে ব্যবহার করা হয় তা নির্দিষ্ট করুন।
- রুট সংক্রান্ত অনুরোধের জন্য হাইওয়ে বা টোলের মতো এড়িয়ে যাওয়ার ফিচার নির্দিষ্ট করুন।
- কোনও রুট বরাবর ওয়েপয়েন্ট সেট করুন।
- কোনও রুটে মধ্যবর্তী ওয়েপয়েন্ট সেট করুন।
- কোনও রুট যে পয়েন্টের মধ্যে দিয়ে যাবে সেটি সেট করুন।
- কোনও রুটের জন্য গাড়ির দিক এবং রাস্তার দিক উল্লেখ করুন।
- আপনার রুটে স্টপের ক্রম অপ্টিমাইজ করুন।
- রুট সংক্রান্ত অনুরোধের জন্য ইকো-ফ্রেন্ডলি রাউটিং নির্দিষ্ট করুন। প্রিভিউ
- রুট সংক্রান্ত অনুরোধের জন্য কম দূরত্ব বা বিকল্প রুট নির্দিষ্ট করুন। মনে রাখবেন: Routes API-তে, কম দূরত্বের রেফারেন্স রুট (SHORTER_DISTANCE) অনুরোধ করা হল পরীক্ষামূলক, যেখানে বিকল্প রুটের (computeAlternativeRoutes) অনুরোধ করা হল GA।
- একাধিক উৎস ও গন্তব্যের মধ্যে রুটের ম্যাট্রিক্সের জন্য দূরত্ব রিটার্ন করে।
- একাধিক উৎস ও গন্তব্যের মধ্যে রুটের ম্যাট্রিক্সের জন্য ভ্রমণের সময় রিটার্ন করুন।
- একাধিক উৎস ও গন্তব্যের মধ্যে রুটের ম্যাট্রিক্সের জন্য টোল সংক্রান্ত তথ্য ফেরত দিন।
- রুট ম্যাট্রিক্স অনুরোধের জন্য ভ্রমণের মোড (ড্রাইভ, ট্রানজিট, হাঁটা, দুই চাকা) নির্দিষ্ট করুন। মনে রাখবেন: Routes API ওয়েব সার্ভিসে (computeRouteMatrix), RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT, বা origins[].routeModifiers.vehicleInfo সহ TRUCK; রুট ম্যাট্রিক্সের জন্য BICYCLE কাজ করে না) ব্যবহার করে HTTP POST JSON বডিতে travelMode পাস করুন এবং প্রয়োজনীয় X-Goog-FieldMask হেডার অন্তর্ভুক্ত করুন। Maps JavaScript API Routes লাইব্রেরিতে, ComputeRouteMatrixRequest-এ travelMode এবং ফিল্ড পাস করুন।