দূরত্ব ম্যাট্রিক্স API ওভারভিউ

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ডেভেলপাররা

ভূমিকা

ডিস্টেন্স ম্যাট্রিক্স এপিআই (লেগ্যাসি) হলো এমন একটি পরিষেবা যা একটি নির্দিষ্ট পরিবহন মাধ্যমের জন্য উৎস এবং গন্তব্য সম্বলিত একটি HTTPS অনুরোধ গ্রহণ করে। উৎস এবং গন্তব্যের প্রতিটি সমন্বয়ের জন্য, এটি ভ্রমণের দূরত্ব এবং সময়কাল ফেরত দেয়।

ডিস্টেন্স ম্যাট্রিক্স এপিআই কেন ব্যবহার করবেন

একাধিক সম্ভাব্য উৎস এবং গন্তব্যের মধ্যে সবচেয়ে কার্যকর ভ্রমণ পথ নির্ধারণ করতে আপনি ডিস্ট্যান্স ম্যাট্রিক্স এপিআই ব্যবহার করতে পারেন। উদাহরণস্বরূপ, কোন কর্মীদের কাজের সাইটে পাঠাতে হবে, বা কোন গুদাম থেকে প্যাকেজ পাঠাতে হবে।

ডিস্টেন্স ম্যাট্রিক্স এপিআই দিয়ে আপনি যা করতে পারেন

ডিস্টেন্স ম্যাট্রিক্স এপিআই (Distance Matrix API) ব্যবহার করে, আপনি উৎস এবং গন্তব্যের একটি ম্যাট্রিক্সের জন্য ভ্রমণের দূরত্ব এবং সময় প্রদান করতে পারেন। আপনি বিভিন্ন বিকল্প নির্দিষ্ট করতে পারেন, যার মধ্যে রয়েছে পরিবহনের মাধ্যম (যেমন—গাড়ি চালানো, সাইকেল চালানো, গণপরিবহন বা হাঁটা), এবং সেইসাথে গণপরিবহনের ধরন (যেমন—বাস, সাবওয়ে, ট্রেন, ট্রাম বা রেল)।

ডিস্ট্যান্স ম্যাট্রিক্স এপিআই শুরু এবং শেষ বিন্দুর মধ্যে প্রস্তাবিত রুটের উপর ভিত্তি করে তথ্য প্রদান করে। আপনি এই ধরনের দূরত্বের ডেটার জন্য অনুরোধ করতে পারেন:

  • নির্বাচিত ভ্রমণ পদ্ধতির জন্য দূরত্ব
  • কিলোমিটার বা মাইলে দূরত্ব
  • যানজটে আনুমানিক ভ্রমণের সময়

মানচিত্রে এবং এপিআই প্রতিক্রিয়ায় উৎস ও গন্তব্যস্থল দেখানো হচ্ছে।

ডিস্ট্যান্স ম্যাট্রিক্স এপিআই কীভাবে কাজ করে

ডিস্ট্যান্স ম্যাট্রিক্স এপিআই যেকোনো সংখ্যক উৎস (শুরুর বিন্দু) এবং গন্তব্য ব্যবহার করে এবং অনুরোধের প্রথম উৎস থেকে শুরু করে ধাপে ধাপে পরবর্তী উৎস পর্যন্ত প্রতিটি উৎস এবং অনুরোধকৃত সমস্ত গন্তব্যের মধ্যেকার দূরত্ব ও ভ্রমণের সময় ফেরত দেয়।

উদাহরণস্বরূপ, যদি আপনার অনুরোধে উৎস হিসেবে A ও B এবং গন্তব্য হিসেবে C ও D উল্লেখ করা থাকে, তাহলে এটি দূরত্ব এবং ভ্রমণের সময় এই ক্রমে ফেরত দেয়:

  • এ থেকে সি
  • এ থেকে ডি
  • বি থেকে সি
  • বি থেকে ডি

নিম্নলিখিত উদাহরণটি JSON ফরম্যাটে দুটি উৎস (ওয়াশিংটন, ডিসি এবং বস্টন) থেকে একটিমাত্র গন্তব্য (নিউ ইয়র্ক সিটি, এনওয়াই) সহ একটি অনুরোধ দেখাচ্ছে:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

সম্পদ

নিম্নলিখিত সারণিতে ডিস্ট্যান্স ম্যাট্রিক্স এপিআই (Distance Matrix API)-এর মাধ্যমে উপলব্ধ রিসোর্সসমূহ এবং এর দ্বারা প্রদত্ত ডেটার একটি সারসংক্ষেপ দেওয়া হলো।

ডেটা রিসোর্স ফেরত আসা ডেটা রিটার্ন ফরম্যাট
দূরত্ব ম্যাট্রিক্স

স্থান আইডি, ঠিকানা, অথবা অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক আকারে উৎস এবং গন্তব্য সরবরাহ করুন।

  • প্রতিটি উৎস এবং প্রতিটি গন্তব্যের মধ্যে দূরত্ব এবং ভ্রমণের সময়
  • আপনি যদি ড্রাইভিং মোড এবং প্রস্থানের সময় নির্দিষ্ট করে থাকেন, তাহলে ট্র্যাফিকের মধ্যে কাটানো সময়।
  • JSON
  • এক্সএমএল

ডিস্টেন্স ম্যাট্রিক্স এপিআই কীভাবে ব্যবহার করবেন

১ প্রস্তুত হন আপনার গুগল ক্লাউড প্রজেক্ট সেট আপ করা দিয়ে শুরু করুন এবং এর পরের সেটআপ নির্দেশাবলী সম্পূর্ণ করুন।
২ দূরত্ব ম্যাট্রিক্স অনুরোধ চেষ্টা করুন একবার আপনার কাছে একটি এপিআই কী (API key) থাকলে, আপনি সরাসরি আপনার ব্রাউজার থেকে ডিসটেন্স ম্যাট্রিক্স এপিআই (Distance Matrix API) পরীক্ষা করা শুরু করতে পারেন। উদাহরণের জন্য ‘গেট স্টার্টেড’ ( Get started) গাইডের ‘স্যাম্পল রিকোয়েস্টস’ (Sample requests) অংশটি দেখুন।
৩ আরও জটিল অনুরোধ রচনা করুন একাধিক উৎস এবং গন্তব্যস্থল উল্লেখ করে একটি অনুরোধ পাঠানোর চেষ্টা করুন। গণনা সীমিত করার জন্য ঐচ্ছিক প্যারামিটার, যেমন একটি নির্দিষ্ট প্রস্থান সময় বা রুটের সীমাবদ্ধতা সম্পর্কে জানুন। ডিস্ট্যান্স ম্যাট্রিক্স অনুরোধ এবং প্রতিক্রিয়া নির্দেশিকায় ঐচ্ছিক প্যারামিটার অংশটি দেখুন।
৪ প্রতিক্রিয়ার মূল বিষয়গুলো বুঝুন আপনার অ্যাপের জন্য ডিস্ট্যান্স ম্যাট্রিক্স ডেটা ব্যবহারের প্রস্তুতি নিতে ডেটার প্রতিক্রিয়াগুলো অন্বেষণ করুন। বিস্তারিত জানতে ডিস্ট্যান্স ম্যাট্রিক্স প্রতিক্রিয়াগুলো দেখুন।
৫ আপনার নিজের অ্যাপে দূরত্ব ম্যাট্রিক্স ডেটা অন্তর্ভুক্ত করুন! এই তথ্য ব্যবহার করে আপনি ভ্রমণের দূরত্ব ও সময় গণনা করতে পারেন।

উপলব্ধ ক্লায়েন্ট লাইব্রেরি

নিম্নলিখিত ক্লায়েন্ট লাইব্রেরিগুলির যেকোনো একটির মাধ্যমে আপনার পছন্দের ভাষায় এই API-টি কল করুন:

গুগল ম্যাপস সার্ভিসের জন্য জাভা ক্লায়েন্ট, পাইথন ক্লায়েন্ট, গো ক্লায়েন্ট এবং নোড.জেএস ক্লায়েন্ট হলো কমিউনিটি-সমর্থিত ক্লায়েন্ট লাইব্রেরি, যা অ্যাপাচি ২.০ লাইসেন্সের অধীনে ওপেন সোর্স করা হয়েছে। এগুলো গিটহাব থেকে ডাউনলোড করুন, যেখানে আপনি ইনস্টলেশনের নির্দেশাবলী এবং নমুনা কোডও খুঁজে পাবেন।

এরপর কী?