Distance Matrix API-এর কুইক রেফারেন্স

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 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 API computeRouteMatrix-এ মাইগ্রেট করুন (X-Goog-FieldMask হেডার সহ)। স্বল্প-মেয়াদী ব্যবস্থা হিসেবে শুধুমাত্র ফর্মের মাধ্যমে লিগ্যাসি API অ্যাক্টিভেট করুন। /maps/legacy#LegacyApiNotActivatedMapError দেখুন।