Distance Matrix API (Legacy) হল একটি ওয়েব পরিষেবা যা প্রতিটি জোড়ার মধ্যে সাজেস্ট করা রুটের উপর ভিত্তি করে, উৎস ও গন্তব্যের ম্যাট্রিক্সের জন্য ভ্রমণের দূরত্ব ও সময় দেখায়। আপনি ট্রাফিক-ভিত্তিক সময়সীমার জন্য ভ্রমণের মোড (ড্রাইভিং, হাঁটা, সাইকেল চালানো, ট্রানজিট), ট্রানজিট মোড, ইউনিট এবং রওনা হওয়ার সময় সেট করতে পারবেন। এটি JSON বা XML রিটার্ন করে।
Distance Matrix API: গুরুত্বপূর্ণ তথ্য
- প্রোডাক্ট: Distance Matrix API
- এছাড়াও এই নামে পরিচিত: Distance Matrix API (Legacy), Distance Matrix (Legacy)
- বিভাগ: রুট
- প্ল্যাটফর্ম: ওয়েব পরিষেবা (REST)
- রান করে: সার্ভার (ব্যাকএন্ড কোড)
- লঞ্চ স্টেজ: GA
- লাইফসাইকেল: লিগ্যাসি
- এর দ্বারা প্রতিস্থাপিত: Routes API
- এক নজরে: Distance Matrix API এক নজরে
Distance Matrix API: কখন ব্যবহার করবেন
Distance Matrix API ব্যবহার করুন যখন:
- আপনি আগে থেকেই এমন একটি প্রোজেক্ট ম্যানেজ করছেন যাতে Distance Matrix API (Legacy) চালু করা আছে এবং
/maps/api/distancematrixকল করে। - সার্ভার থেকে একাধিক যাত্রা শুরুর স্থান ও একাধিক গন্তব্যের মধ্যে ভ্রমণের দূরত্ব ও সময় জানতে হবে।
- ড্রাইভিংয়ের জন্য ট্রাফিকের মধ্যে সময়কাল,
departure_timeএবং ঐচ্ছিকtraffic_modelব্যবহার করতে হবে।
Distance Matrix API ব্যবহার করবেন না যখন:
- আপনি একটি নতুন Google Cloud প্রোজেক্ট শুরু করছেন। অক্টোবর ২০২৬ থেকে, নতুন প্রোজেক্টের জন্য Distance Matrix API (Legacy) চালু করা যাবে না। পরিবর্তে Routes API ব্যবহার করুন।
- আপনার নতুন ফিচার বা স্ট্রিম করা রেসপন্স (
computeRouteMatrix) সহ সর্বাধিক ৬২৫টি এলিমেন্টের রুট ম্যাট্রিক্স প্রয়োজন। এর পরিবর্তে Routes API ব্যবহার করুন। - আপনার শুধু দূরত্ব ও সময়সীমার ভ্যালু নয়, পয়েন্টের মধ্যে ধাপ ও পলিলাইন সহ সম্পূর্ণ রুট প্রয়োজন। পরিবর্তে Routes API ব্যবহার করুন।
Distance Matrix API: সেট-আপ
- পরিষেবা চালু করতে:
distance-matrix-backend.googleapis.com - যাচাইকরণ: API key
- শুরু করা: Distance Matrix API সেট-আপ করুন
- রেফারেন্স: Distance Matrix API রেফারেন্স
- দাম: Distance Matrix API-এর ব্যবহার ও বিলিং
- নীতি: Distance Matrix API সংক্রান্ত নীতি
- রিলিজ নোট: Distance Matrix API রিলিজ নোট
Distance Matrix API: সাধারণ ভুল
- সমস্যা: সার্ভার-সাইড প্রতিটি অনুরোধ ১০০টি এলিমেন্ট (উৎস × গন্তব্য) এবং ২৫টি উৎস বা ২৫টি গন্তব্যের মধ্যে সীমাবদ্ধ। আরও বড় অনুরোধের ক্ষেত্রে
MAX_ELEMENTS_EXCEEDEDবাMAX_DIMENSIONS_EXCEEDEDফেরত আসে। সমাধান: ম্যাট্রিক্সকে ১০০টির বেশি এলিমেন্ট এবং ২৫টি উৎস বা গন্তব্য নেই এমন অনুরোধে ভাগ করুন। /maps/documentation/distance-matrix/usage-and-billing#usage-limits দেখুন। - সমস্যা: আপনি
departure_timeউল্লেখ না করলে, রুট ও সময়কাল গড় সময়-নিরপেক্ষ ট্রাফিকের উপর ভিত্তি করে দেখানো হয় এবং কোনওduration_in_trafficদেখানো হয় না। সময়ের সাথে সাথে ফলাফল আলাদা হতে পারে। সমাধান: ট্রাফিক-সচেতন সময়কাল পেতেdeparture_time-কেnow-এ সেট করুন অথবাmode=driving-এর সাথে ভবিষ্যতের কোনও সময় সেট করুন। মনে রাখবেন, ট্রাফিক সংক্রান্ত অনুরোধের জন্য বেশি রেটে বিল করা হয়। /maps/documentation/distance-matrix/distance-matrix দেখুন। - সমস্যা:
unitsপ্যারামিটার শুধুমাত্র দূরত্বের ফিল্ডে টেক্সট পরিবর্তন করে। দূরত্বের মান সবসময় মিটারে দেখানো হয়। সমাধান:distance.value-কে মিটার হিসেবে পড়ুন অথবা দেখানোর জন্যdistance.textব্যবহার করুন। /maps/documentation/distance-matrix/distance-matrix দেখুন। - সমস্যা: যে প্রোজেক্টে Distance Matrix API (Legacy) চালু করা নেই, সেখানে এটি কল করলে
status-এREQUEST_DENIEDএবংLegacyApiNotActivatedMapError-এর সাথে লিঙ্ক করাerror_messageদেখায়। AI অ্যাসিস্ট্যান্ট সাধারণত ডিফল্ট হিসেবে লিগ্যাসি-API কোড জেনারেট করে। সমাধান: Routes APIcomputeRouteMatrix-এ মাইগ্রেট করুন (X-Goog-FieldMaskহেডার সহ)। স্বল্প-মেয়াদী ব্যবস্থা হিসেবে শুধুমাত্র ফর্মের মাধ্যমে লিগ্যাসি API অ্যাক্টিভেট করুন। /maps/legacy#LegacyApiNotActivatedMapError দেখুন।