Directions API (Legacy) হল একটি ওয়েব পরিষেবা যা গাড়ি চালানো, হাঁটা, সাইকেল চালানো এবং ট্রানজিটের জন্য লোকেশনের মধ্যে দিকনির্দেশ গণনা করে, যার মধ্যে ওয়েপয়েন্ট সহ মাল্টিপার্ট রুট অন্তর্ভুক্ত এবং JSON বা XML-এ রুট, লেগ এবং ধাপগুলি ফেরত দেয়। এটি লিগ্যাসি স্ট্যাটাসে আছে: অক্টোবর ২০২৬ থেকে এটি নতুন Google Cloud প্রোজেক্টের জন্য চালু করা যাবে না; Routes API-তে মাইগ্রেট করুন।
Directions API: গুরুত্বপূর্ণ তথ্য
- প্রোডাক্ট: Directions API
- এছাড়াও এই নামে পরিচিত: Directions API (পুরনো ভার্সন)
- বিভাগ: রুট
- প্ল্যাটফর্ম: ওয়েব পরিষেবা (REST)
- রান করে: সার্ভার (ব্যাকএন্ড কোড)
- লঞ্চ স্টেজ: GA
- লাইফসাইকেল: লিগ্যাসি
- এর দ্বারা প্রতিস্থাপিত: Routes API
- এক নজরে: Directions API এক নজরে
- আঞ্চলিক উপলভ্যতা: বিশ্বব্যাপী। অঞ্চল ও ভ্রমণের মোড অনুযায়ী কভারেজ আলাদা হয় (ট্রানজিট পরিষেবা প্রদানকারীর থেকে পাওয়া ডেটার উপর ট্রানজিট নির্ভর করে)। (কভারেজ সংক্রান্ত বিবরণ)
Directions API: কখন ব্যবহার করবেন
Directions API ব্যবহার করুন যখন:
- আপনি আগে থেকেই রয়েছে এমন Google Cloud প্রোজেক্ট ম্যানেজ করেন যেখানে আগে থেকেই Directions API (Legacy) চালু করা আছে এবং
maps/api/directionsকল করে। - আপনার আগে থেকে থাকা প্রোজেক্টে JSON বা XML-এ ড্রাইভিং, হাঁটা, সাইকেল চালানো বা ট্রানজিটের (শুধুমাত্র নন-ট্রানজিট মোডের জন্য ওয়েপয়েন্ট) জন্য সার্ভার-সাইড দিকনির্দেশ প্রয়োজন।
Directions API ব্যবহার করবেন না যখন:
- আপনি একটি নতুন Google Cloud প্রোজেক্ট শুরু করছেন; অক্টোবর ২০২৬ থেকে নতুন প্রোজেক্টের জন্য Directions API (Legacy) চালু করা যাবে না। পরিবর্তে Routes API ব্যবহার করুন।
- আপনার নতুন রাউটিং ফিচার ও উন্নত পারফর্ম্যান্স প্রয়োজন। পরিবর্তে Routes API ব্যবহার করুন।
- একটি অনুরোধে অনেক উৎস এবং গন্তব্যের জন্য ভ্রমণের সময় এবং দূরত্ব প্রয়োজন। পরিবর্তে Routes API ব্যবহার করুন।
Directions API: সেট-আপ
- পরিষেবা চালু করতে:
directions-backend.googleapis.com - যাচাইকরণ: API key
- শুরু করুন: Directions API সেট-আপ করুন
- রেফারেন্স: Directions API রেফারেন্স
- দাম: Directions API ব্যবহার ও বিলিং
- নীতি: Directions API সংক্রান্ত নীতি
- রিলিজ নোট: Directions API রিলিজ নোট
Directions API: সাধারণ ভুল
- সমস্যা: কোনও প্রোজেক্টে লিগ্যাসি API চালু না থাকলে, সেখান থেকে Directions API (লিগ্যাসি)-তে করা অনুরোধ
LegacyApiNotActivatedMapError-এর কারণে ব্যর্থ হয়। সমাধান: আপনি অ্যাপের মালিক হলে, Routes API-তে মাইগ্রেট করুন। আপনি মাইগ্রেট করার সময় বা অ্যাপ আপডেটের জন্য অপেক্ষা করার সময় স্বল্পমেয়াদী সমাধান হিসেবে, লিগ্যাসি API অ্যাক্টিভেশন ফর্ম পূরণ করে লিগ্যাসি API অ্যাক্টিভেট করতে পারবেন। /maps/legacy দেখুন। - সমস্যা: ওয়েপয়েন্টে
via:প্রিফিক্স ব্যবহার করলে, সেগুলি কঠোরভাবে পাস-থ্রু হয়ে যায়, যার ফলে গুরুতরভাবে পথ পরিবর্তন করতে হতে পারে অথবাZERO_RESULTSস্ট্যাটাস দেখা যেতে পারে। সমাধান: কঠোরভাবে পাস-থ্রু পয়েন্টের প্রয়োজন না হলে, স্টপওভার ওয়েপয়েন্ট (via:প্রিফিক্স ছাড়া) ব্যবহার করুন। /maps/documentation/directions/get-directions দেখুন। - সমস্যা: ১১ থেকে ২৫টি ওয়েপয়েন্ট,
optimize:true, ট্রাফিক-অ্যাওয়ার সময়সীমা (duration_in_traffic) বাside_of_roadঅথবাheadingলোকেশন মডিফায়ার সহ অনুরোধের জন্য আরও বেশি মূল্যের Directions Advanced (Pro) SKU-তে বিল করা হয়। সমাধান: শুধুমাত্র প্রয়োজন হলে তবেই এইসব ফিচার ব্যবহার করুন; ওয়েপয়েন্ট ১০ বা তার কম রাখুন এবং Essentials SKU-তে থাকতেoptimize:true,departure_time(ড্রাইভিংয়ের জন্য),side_of_roadওheadingবাদ দিন। /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku দেখুন। - সমস্যা: ড্রাইভিংয়ের ক্ষেত্রে,
departure_timeঅতীতে হতে পারে না (অনুরোধINVALID_REQUEST-এর সাথে ব্যর্থ হয়)।departure_timeছাড়া, রুট এবং সময়কাল গড় সময়-স্বাধীন ট্রাফিক ব্যবহার করে এবং কোনওduration_in_trafficফেরত দেওয়া হয় না। সমাধান:duration_in_trafficপেতেdeparture_time-কেnow-এ সেট করুন অথবাmode=driving-এর সাথে ভবিষ্যতের কোনও সময় সেট করুন।duration_in_trafficরিটার্ন করে এমন অনুরোধের জন্য Directions Advanced (Pro) SKU-তে বিল করা হয়। /maps/documentation/directions/get-directions দেখুন।