রাস্তার API ওভারভিউ

Roads API হলো এমন একটি পরিষেবা যা মানচিত্রের এক বা একাধিক বিন্দুর অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কসহ HTTPS অনুরোধ গ্রহণ করে। এটি এই বিন্দুগুলো ব্যবহার করে নিকটবর্তী সড়ক অংশ খুঁজে বের করে এবং নিকটতম সড়ক অংশ ও গতিসীমার মতো মেটাডেটাসহ একটি প্লেস আইডি ফেরত দেয়।

Roads API কেন ব্যবহার করবেন

Roads API মাধ্যমে আপনি গতিসীমা, আনুমানিক পৌঁছানোর সময় বা রাস্তার অন্যান্য মেটাডেটা পেতে পারেন। এই রোড মেটাডেটা ব্যবহার করে আপনি আপনার ড্রাইভিং অ্যাপগুলোকে নিম্নলিখিত সক্ষমতাগুলো দিয়ে আরও উন্নত করতে পারেন:

  • অক্ষাংশ/দ্রাঘিমাংশের স্থানাঙ্ককে একটি বা একাধিক রাস্তার সাথে সংযুক্ত করুন।
  • একটি স্থানাঙ্ক সেটের জন্য নিকটতম রাস্তাটি খুঁজুন।
  • রাস্তার অংশগুলোর জন্য গতিসীমা জানুন

Roads API দিয়ে আপনি যা করতে পারেন

Roads API সাহায্যে, আপনি GPS স্থানাঙ্ককে রাস্তার জ্যামিতির সাথে সংযুক্ত করতে পারেন এবং রাস্তার বিভিন্ন অংশ বরাবর গতিসীমা নির্ধারণ করতে পারেন।

  • স্ন্যাপ টু রোডস এই পরিষেবাটি প্রদত্ত জিপিএস স্থানাঙ্কের উপর ভিত্তি করে সবচেয়ে সম্ভাব্য ভ্রমণপথগুলো ফেরত দেয়। আপনি একটি রুট বরাবর সংগৃহীত ১০০টি পর্যন্ত জিপিএস পয়েন্ট নির্দিষ্ট করতে পারেন। ঐচ্ছিকভাবে, আপনি পরিষেবাটিকে অতিরিক্ত পয়েন্ট ইন্টারপোলেট করার জন্য অনুরোধও করতে পারেন, যার ফলে এমন একটি পথ তৈরি হয় যা রাস্তার জ্যামিতিকে মসৃণভাবে অনুসরণ করে।
  • নিকটতম রাস্তা এই পরিষেবাটি একটি GPS পয়েন্টের জন্য নিকটতম রাস্তার অংশটি খুঁজে দেয়। আপনি সর্বোচ্চ ১০০টি GPS পয়েন্ট নির্দিষ্ট করতে পারেন। আপনার নির্দিষ্ট করা পয়েন্টগুলো একটি অবিচ্ছিন্ন পথের অংশ হওয়ার প্রয়োজন নেই।
  • গতিসীমা এই পরিষেবাটি রাস্তার কোনো একটি অংশের জন্য নির্ধারিত গতিসীমা দেখিয়ে দেয়। অ্যাসেট ট্র্যাকিং লাইসেন্স আছে এমন সকল গ্রাহকের জন্য স্পিড লিমিট পরিষেবাটি উপলব্ধ। গুগল ম্যাপস প্ল্যাটফর্ম প্রিমিয়াম প্ল্যানের যে সকল গ্রাহক পে-অ্যাজ-ইউ-গো প্রাইসিং-এ স্থানান্তরিত হয়েছেন, তাদের জন্যও এই ফিচারটি সক্রিয় রয়েছে।

Roads API কীভাবে কাজ করে

Roads API তিনটি এন্ডপয়েন্ট ব্যবহার করে, যেগুলো রাস্তার পথ, সেগমেন্ট বা গতিসীমার ডেটা সরবরাহ করার জন্য অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক অথবা স্থান আইডি গ্রহণ করে। নিম্নলিখিত উদাহরণটি এক সেট অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের উপর ভিত্তি করে নিকটতম রাস্তাগুলোর জন্য একটি অনুরোধ দেখাচ্ছে:

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

সম্পদ

নিম্নলিখিত সারণিতে Roads API এর মাধ্যমে উপলব্ধ রিসোর্সসমূহ এবং এর থেকে প্রাপ্ত ডেটার একটি সারসংক্ষেপ দেওয়া হয়েছে।

ডেটা রিসোর্স ফেরত আসা ডেটা রিটার্ন ফরম্যাট
রাস্তায় স্ন্যাপ করুন

একটি রুট থেকে সর্বোচ্চ ১০০টি জিপিএস পয়েন্টের একটি অ্যারে ফেরত দেয়। এতে স্থান আইডি-র সাথে রাস্তা থেকে নেওয়া দ্রাঘিমাংশ/অক্ষাংশ স্থানাঙ্ক অন্তর্ভুক্ত থাকে। বিস্তারিত জানতে 'Snap to roads' গাইডের 'Responses' অংশটি দেখুন।

  • JSON
নিকটতম রাস্তা

প্রতিটি নির্দিষ্ট পয়েন্টের জন্য নিকটতম রাস্তার স্থান আইডি সহ সর্বোচ্চ ১০০টি স্বতন্ত্র অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের একটি অ্যারে। পয়েন্টগুলো অবিচ্ছিন্ন হওয়ার প্রয়োজন নেই। নিকটতম রাস্তা নির্দেশিকার ‘প্রতিক্রিয়া’ অংশে বিস্তারিত দেখুন।

গতিসীমা

সর্বোচ্চ ১০০টি সড়ক মেটাডেটা উপাদানের একটি অ্যারে। এগুলিতে গতিসীমা এবং স্থানের আইডি থাকে, যার একক হয় কিলোমিটার প্রতি ঘণ্টা (KPH) অথবা মাইল প্রতি ঘণ্টা (MPH)। গতিসীমা নির্দেশিকার ‘প্রতিক্রিয়া’ (Responses ) অংশে বিস্তারিত দেখুন।

Roads API কীভাবে ব্যবহার করবেন

১ স্ন্যাপ টু রোডস ডেমোটি ব্যবহার করে দেখুন একটি ট্র্যাক তৈরি করতে ডেমোতে ক্লিক করুন এবং দেখুন কীভাবে 'স্ন্যাপ টু রোডস' এন্ডপয়েন্টটি মসৃণ ডেটা সরবরাহ করে। 'স্ন্যাপ টু রোডস' গাইডে ডেমোটি দেখুন। আপনার কোনো এপিআই কী-এর প্রয়োজন নেই।
২ প্রস্তুত হন আপনার গুগল ক্লাউড প্রজেক্ট সেট আপ করার মাধ্যমে শুরু করুন এবং পরবর্তী সেটআপ নির্দেশাবলী সম্পূর্ণ করুন, তারপর আপনার এপিআই কী (API key) কীভাবে ব্যবহার করতে হয় তা শিখে নিন।
৩ রাস্তাগুলির জন্য একটি স্ন্যাপ অনুরোধ চেষ্টা করুন স্ন্যাপ টু রোডস উদাহরণগুলোর মধ্যে একটি ব্যবহার করুন এবং আপনার ব্যবহারের ক্ষেত্রের সাথে প্রাসঙ্গিক একটি চেষ্টা করে দেখুন।
৪ আপনার রাস্তার পথের জন্য গতিসীমা জেনে নিন। আপনার 'স্ন্যাপ টু রোডস' অনুরোধের জন্য দেওয়া একই পাথ ডেটা ব্যবহার করে, একটি গতিসীমা কোয়েরি পাঠান। 'পাথ ব্যবহার করে উদাহরণ অনুরোধ' দেখুন।
৫ দীর্ঘ পথগুলি কীভাবে প্রক্রিয়া করতে হয় তা শিখুন অ্যাডভান্সড কনসেপ্টস গাইডের 'প্রসেসিং লং পাথস' অধ্যায়গুলো অনুসরণ করুন।
৬ আপনার নিজের অ্যাপে রাস্তার তথ্য অন্তর্ভুক্ত করুন! আপনার নিজের অ্যাপে রাস্তার ডেটা কার্যকারিতা তৈরি করা শুরু করতে, রোড স্ন্যাপড ডেমো থেকে বিস্তারিত কোড উদাহরণটি দেখুন।

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

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

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

এরপর কী?