দূরত্ব ম্যাট্রিক্স এপিআই (লেগ্যাসি) এর সংক্ষিপ্ত বিবরণ

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

ভূমিকা

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

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

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

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

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

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

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

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

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

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

উদাহরণস্বরূপ, যদি আপনার অনুরোধে উৎস হিসেবে 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

সম্পদ

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

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

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

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

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

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

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

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

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

এরপর কী?