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

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

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

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

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

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

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

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

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 মাধ্যমে উপলব্ধ রিসোর্সগুলির সাথে এটি যে ডেটা ফেরত দেয় তার সারসংক্ষেপ দেওয়া হয়েছে।

তথ্য সম্পদ ডেটা ফেরত দেওয়া হয়েছে রিটার্ন ফর্ম্যাট
রাস্তাগুলিতে স্ন্যাপ করুন

একটি রুট থেকে ১০০টি পর্যন্ত GPS পয়েন্টের একটি অ্যারে ফেরত পাঠায়। স্থান আইডি সহ রাস্তা-স্ন্যাপ করা দ্রাঘিমাংশ/অক্ষাংশ স্থানাঙ্ক অন্তর্ভুক্ত করে। স্ন্যাপ টু রোডস গাইডের প্রতিক্রিয়াগুলিতে বিশদ দেখুন।

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

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

গতিসীমা

১০০টি পর্যন্ত রোড মেটাডেটা উপাদানের একটি অ্যারে। এগুলিতে গতি সীমা এবং স্থান আইডি থাকে, যার ইউনিট হয় KPH অথবা MPH-তে থাকে। গতি সীমা নির্দেশিকার প্রতিক্রিয়া বিভাগে বিস্তারিত দেখুন।

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

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

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

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

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

এরপর কি?