জিওকোডিং এপিআই হলো এমন একটি পরিষেবা যা কোনো স্থানের ঠিকানা, অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক অথবা প্লেস আইডি গ্রহণ করে। এটি ঠিকানাটিকে অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক এবং একটি প্লেস আইডিতে রূপান্তর করে, অথবা অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক বা একটি প্লেস আইডিকে ঠিকানায় রূপান্তর করে।
জিওকোডিং এপিআই দিয়ে আপনি যা করতে পারেন
আপনি এক বা একাধিক ঠিকানা বা স্থানের জন্য জিওকোডিং ডেটা পেতে জিওকোডিং এপিআই ব্যবহার করতে পারেন, যার মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
জিওকোডিং এপিআই ভি৪-এর এই সংস্করণে নিম্নলিখিত এন্ডপয়েন্টগুলো অন্তর্ভুক্ত করা হয়েছে:
- ঠিকানা জিওকোড করুন — ঠিকানার ভৌগোলিক স্থানাঙ্ক। একে ফরোয়ার্ড জিওকোডিংও বলা হয়।
- কোনো অবস্থানের জিওকোড নির্ধারণ — অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক সেটের জন্য ঠিকানা। একে রিভার্স জিওকোডিংও বলা হয়।
- স্থান ভূ-কোডিং — কোনো স্থানের আইডি থেকে ঠিকানা পুনরুদ্ধার করুন।
- গন্তব্য অনুসন্ধান করুন — ঠিকানা, স্থান আইডি বা অবস্থান থেকে কোনো গন্তব্য অনুসন্ধান করুন।
আপনি ফলাফলগুলো কোথায় প্রদর্শিত হবে তা নিয়ন্ত্রণ করতে পারেন এবং ফলাফলগুলোকে একটি নির্দিষ্ট অঞ্চল, কাউন্টি বা পোস্টাল কোডে সীমাবদ্ধ করতে পারেন।
ডেমোটি চেষ্টা করে দেখুন
জিওকোডিং এপিআই কীভাবে কাজ করে
জিওকোডিং এপিআই জিওকোডিং এবং রিভার্স জিওকোডিং উভয়ই করে থাকে:
- জিওকোডিং : "1600 Amphitheatre Parkway, Mountain View, CA"-এর মতো ঠিকানাগুলিকে অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক বা স্থান আইডি-তে রূপান্তর করে। আপনি এই স্থানাঙ্কগুলি ব্যবহার করে মানচিত্রে মার্কার স্থাপন করতে পারেন, অথবা ভিউ ফ্রেমের মধ্যে মানচিত্রটিকে কেন্দ্র করতে বা তার অবস্থান পরিবর্তন করতে পারেন।
- রিভার্স জিওকোডিং : অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক অথবা একটি স্থানের আইডিকে মানুষের পাঠযোগ্য ঠিকানায় রূপান্তরিত করে। আপনি ডেলিভারি বা পিকআপ সহ বিভিন্ন পরিস্থিতিতে ঠিকানা ব্যবহার করতে পারেন।
নিম্নলিখিত সারণিতে জিওকোডিং এপিআই-এর মাধ্যমে উপলব্ধ রিসোর্সগুলোর সারসংক্ষেপ এবং প্রতিটি মেথড দ্বারা প্রত্যাবর্তিত ডেটা তুলে ধরা হলো।
| ডেটা রিসোর্স | ফেরত আসা ডেটা | রিটার্ন ফরম্যাট |
|---|---|---|
| জিওকোডিং | ঠিকানা, ঠিকানার উপাদান এবং ঠিকানার প্রকারভেদ ফেরত দেয়। জিওকোড রেসপন্স ডকুমেন্টেশন দেখুন। |
|
| বিপরীত ভূ-কোডিং | ঠিকানা, ঠিকানার উপাদান এবং ঠিকানার প্রকার ফেরত দেয়। রিভার্স জিওকোডিং রেসপন্স ডকুমেন্টেশন দেখুন। | |
| স্থান ভূ-কোডিং | ঠিকানা, ঠিকানার উপাদান এবং ঠিকানার প্রকারভেদ ফেরত দেয়। প্লেস জিওকোডিং রেসপন্স ডকুমেন্টেশন দেখুন। | |
| গন্তব্য অনুসন্ধান | ঠিকানা, স্থান আইডি, বা অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্কের মতো বিভিন্ন ইনপুট শর্তের উপর ভিত্তি করে নানা গন্তব্যস্থল সম্পর্কে বিস্তারিত তথ্য প্রদান করে। গন্তব্যস্থল অনুসন্ধান ডকুমেন্টেশন দেখুন। |
জিওকোডিং এপিআই ভি৪-এর বৈশিষ্ট্যসমূহ
জিওকোডিং এপিআই-এর সংস্করণ ৪-এ এই নতুন বৈশিষ্ট্যগুলো রয়েছে।
গন্তব্য অনুসন্ধান পদ্ধতি
v4-এ একটি নতুন গন্তব্য অনুসন্ধান পদ্ধতি চালু করা হয়েছে, যা আপনাকে ঠিকানা, স্থান আইডি, বা অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্কের মতো বিভিন্ন ইনপুট মানদণ্ডের উপর ভিত্তি করে নানা গন্তব্য সম্পর্কে বিস্তারিত তথ্য পেতে সাহায্য করে। এর প্রতিক্রিয়ায় এআই-চালিত সারাংশ এবং নেভিগেশন পয়েন্ট টোকেন অন্তর্ভুক্ত থাকে, যেগুলিতে প্রাসঙ্গিক তথ্য থাকে এবং যা নির্ভুল রুটিংয়ের জন্য নেভিগেশন এসডিকে- তে পাঠানো যেতে পারে।
গুগল ক্লাউড স্ট্যান্ডার্ড প্ল্যাটফর্মে বাস্তবায়িত
জিওকোডিং এপিআই ভি৪ গুগল ক্লাউডের সার্ভিস ইনফ্রাস্ট্রাকচারে প্রয়োগ করা হয়েছে। এই প্রয়োগটি OAuth-এর মতো উন্নত নিরাপত্তা বিকল্পসহ একটি অধিক সুরক্ষিত ও বিশ্বস্ত প্ল্যাটফর্ম নিয়ে আসে। এই স্ট্যান্ডার্ড এপিআই ডিজাইনটি এপিআইগুলোর মধ্যে একটি সামঞ্জস্যতা নিয়ে আসে, যা জিওকোডিং এপিআই ভি৪ ব্যবহার করে ডেভেলপমেন্টের কার্যকারিতা উন্নত করে।
OAuth সমর্থন যোগ করা হয়েছে
জিওকোডিং এপিআই ভি৪ প্রমাণীকরণের জন্য ওঅথ ২.০ (OAuth 2.0) ব্যবহার সমর্থন করে। গুগল একটি ওয়েব সার্ভারের মতো সাধারণ ওঅথ ২.০ পরিস্থিতিগুলো সমর্থন করে।
ফিল্ড মাস্ক সাপোর্ট যোগ করা হয়েছে
রেসপন্সে কী কী তথ্য ফেরত আসবে তা নির্দিষ্ট করতে ফিল্ড মাস্ক ব্যবহার করুন। ‘Geocode an address’ , ‘Geocode a location’ , এবং ‘Place’ জিওকোডিং মেথডগুলোর ক্ষেত্রে, রেসপন্স অবজেক্টের সমস্ত ফিল্ড ডিফল্টভাবে ফেরত আসে। ‘Search for destinations’ মেথডটির জন্য, আপনাকে এপিআই রিকোয়েস্টে অবশ্যই একটি ফিল্ড মাস্ক নির্দিষ্ট করতে হবে।
এপিআই নিরাপত্তা
জিওকোডিং এপিআই ভি৪ একটি সার্ভার-টু-সার্ভার এপিআই হিসেবে ডিজাইন করা হয়েছে। ব্রাউজার থেকে সরাসরি ক্লায়েন্ট-সাইড কল এপিআই কী-গুলোকে চুরি এবং অপব্যবহারের উল্লেখযোগ্য ঝুঁকিতে ফেলে, কারণ ওয়েব সার্ভিস এন্ডপয়েন্টগুলোর জন্য এইচটিটিপি রেফারার সীমাবদ্ধতা যথেষ্ট সুরক্ষা প্রদান করে না।
আমরা দৃঢ়ভাবে সুপারিশ করছি যে আপনি আপনার নিজস্ব ব্যাকএন্ড সার্ভার থেকে জিওকোডিং এপিআই ভি৪ (Geocoding API v4) কল করুন। ক্লায়েন্ট-সাইডের প্রয়োজনের জন্য নিরাপদ বাস্তবায়ন পদ্ধতি এবং বিকল্প সম্পর্কে আরও বিস্তারিত জানতে, নিরাপত্তা সংক্রান্ত বিবেচ্য বিষয়সমূহ (Security considerations) দেখুন।