Geocoding API হল এমন একটি পরিষেবা যা কোনও ঠিকানার জিওকোডিং ও রিভার্স জিওকোডিং প্রদান করে।
জিওকোডিং হল এমন একটি প্রসেস যার মাধ্যমে ঠিকানা (যেমন, রাস্তার ঠিকানা) থেকে ভৌগোলিক কোঅর্ডিনেট (যেমন, অক্ষাংশ ও দ্রাঘিমাংশ) কনভার্ট করা হয়, যা আপনি ম্যাপে মার্কার প্লেস করতে বা ম্যাপের পজিশন সেট করতে ব্যবহার করতে পারেন।
রিভার্স জিওকোডিং হল ভৌগোলিক কোঅর্ডিনেটকে মানুষের-পাঠযোগ্য অ্যাড্রেসে কনভার্ট করার প্রসেস।
এছাড়াও, প্রদত্ত প্লেস আইডির জন্য ঠিকানা খুঁজে পেতে আপনি জিওকোডিং API ব্যবহার করতে পারেন।
অনুরোধ ও উত্তরের নমুনা
আপনি HTTP ইন্টারফেসের মাধ্যমে Geocoding API অ্যাক্সেস করেন। নিচে জিওকোডিং ও রিভার্স জিওকোডিং সংক্রান্ত অনুরোধের উদাহরণ দেওয়া হল।
জিওকোডিং সংক্রান্ত অনুরোধ ও উত্তর (অক্ষাংশ/দ্রাঘিমাংশ লুক-আপ)
নিম্নলিখিত উদাহরণে "1600 Amphitheatre Parkway, Mountain View, CA"-এর অক্ষাংশ ও দ্রাঘিমাংশ জানতে চাওয়া হয়েছে এবং উল্লেখ করা হয়েছে যে আউটপুট JSON ফর্ম্যাটে হতে হবে।
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
আপনার ওয়েব ব্রাউজারে URL লিখে এটি পরীক্ষা করে দেখতে পারেন (আপনার আসল API কী দিয়ে
YOUR_API_KEY পরিবর্তন করতে ভুলবেন না)।
উত্তরে ঠিকানার অক্ষাংশ ও দ্রাঘিমাংশ উল্লেখ করা হয়েছে।
ডেভেলপার নির্দেশিকা দেখুন, যাতে জিওকোডিং অনুরোধ URL তৈরি করা এবং উপলভ্য প্যারামিটার ও উত্তর বোঝা সম্পর্কে আরও তথ্য পাবেন।
নিচে JSON-এ একটি নমুনা জিওকোডিং উত্তর দেওয়া হল:
{ "results" : [ { "address_components" : [ { "long_name" : "1600", "short_name" : "1600", "types" : [ "street_number" ] }, { "long_name" : "Amphitheatre Parkway", "short_name" : "Amphitheatre Pkwy", "types" : [ "route" ] }, { "long_name" : "Mountain View", "short_name" : "Mountain View", "types" : [ "locality", "political" ] }, { "long_name" : "Santa Clara County", "short_name" : "Santa Clara County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "California", "short_name" : "CA", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "94043", "short_name" : "94043", "types" : [ "postal_code" ] } ], "formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "geometry" : { "location" : { "lat" : 37.4267861, "lng" : -122.0806032 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 37.4281350802915, "lng" : -122.0792542197085 }, "southwest" : { "lat" : 37.4254371197085, "lng" : -122.0819521802915 } } }, "place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE", "plus_code" : { "compound_code" : "CWC8+R3 Mountain View, California, United States", "global_code" : "849VCWC8+R3" }, "types" : [ "street_address" ] } ], "status" : "OK" }
রিভার্স জিওকোডিং সংক্রান্ত অনুরোধ ও উত্তর (ঠিকানা খোঁজা)
নিম্নলিখিত উদাহরণে মার্কিন যুক্তরাষ্ট্রের নিউইয়র্কের ব্রুকলিনের অক্ষাংশ/দ্রাঘিমাংশ অনুযায়ী ঠিকানা চাওয়া হয়েছে। এটি নির্দিষ্ট করে যে আউটপুট অবশ্যই JSON ফর্ম্যাটে হতে হবে।
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEYআপনার ওয়েব ব্রাউজারে URL লিখে এটি পরীক্ষা করতে পারবেন ('YOUR_API_KEY' আপনার আসল API key দিয়ে পরিবর্তন করতে ভুলবেন না)। উত্তরে অক্ষাংশ ও দ্রাঘিমাংশ লোকেশনের জন্য মানুষের-পঠনযোগ্য ঠিকানা অন্তর্ভুক্ত আছে।
ডেভেলপার নির্দেশিকা দেখুন, যাতে রিভার্স জিওকোডিং অনুরোধ URL তৈরি করা এবং উপলভ্য প্যারামিটার এবং উত্তর বোঝা সম্পর্কে আরও তথ্য পাবেন।
নিচে JSON-এ একটি স্যাম্পেল রিভার্স জিওকোডিং রেসপন্স দেওয়া হল:
{ "plus_code" : { "compound_code" : "P27Q+MC New York, NY, USA", "global_code" : "87G8P27Q+MC" }, "results" : [ { "address_components" : [ { "long_name" : "279", "short_name" : "279", "types" : [ "street_number" ] }, { "long_name" : "Bedford Avenue", "short_name" : "Bedford Ave", "types" : [ "route" ] }, { "long_name" : "Williamsburg", "short_name" : "Williamsburg", "types" : [ "neighborhood", "political" ] }, { "long_name" : "Brooklyn", "short_name" : "Brooklyn", "types" : [ "political", "sublocality", "sublocality_level_1" ] }, { "long_name" : "Kings County", "short_name" : "Kings County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "New York", "short_name" : "NY", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "11211", "short_name" : "11211", "types" : [ "postal_code" ] } ], "formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA", "geometry" : { "location" : { "lat" : 40.7142484, "lng" : -73.9614103 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 40.71559738029149, "lng" : -73.9600613197085 }, "southwest" : { "lat" : 40.71289941970849, "lng" : -73.96275928029151 } } }, "place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE", "plus_code" : { "compound_code" : "P27Q+MC Brooklyn, New York, United States", "global_code" : "87G8P27Q+MC" }, "types" : [ "bakery", "cafe", "establishment", "food", "point_of_interest", "store" ] }, ... Additional results truncated in this example[] ... ], "status" : "OK" }
আমাদের ক্লায়েন্ট লাইব্রেরির মাধ্যমে কোডিং শুরু করা
ক্লায়েন্ট লাইব্রেরি আপনাকে Google Maps ওয়েব সার্ভিস API-এর সাহায্যে ডেভেলপ করতে সাহায্য করে। এটি করার জন্য, এটি যাচাইকরণ, অনুরোধ থ্রটলিং এবং অটোমেটিক আবার চেষ্টা করার মতো সাধারণ টাস্কের বিল্ট-ইন ইমপ্লিমেন্টেশন প্রদান করে। Geocoding API Java Client, Python Client, Go Client এবং Node.js Client for Google Maps Services-এ উপলভ্য।
যাচাইকরণ, কোটা, দাম ও নীতি
যাচাইকরণ
Geocoding API ব্যবহার করতে হলে, আপনাকে প্রথমে API চালু করতে হবে এবং সঠিক যাচাইকরণ ক্রেডেনশিয়াল পেতে হবে। আরও তথ্যের জন্য, Google Maps Platform ব্যবহার করা শুরু করুন দেখুন।
কোটা ও দাম
Geocoding API-এর জন্য কোটা ও দাম সংক্রান্ত বিবরণ পেতে, ব্যবহার ও বিলিং পৃষ্ঠা দেখুন।
নীতি
Geocoding API-এর ব্যবহার অবশ্যই API নীতি অনুযায়ী হতে হবে।
আরও জানুন
Geocoding API-এর সাহায্যে আপনি আরও অনেক কিছু করতে পারবেন। অতিরিক্ত ডেমো, উদাহরণ, উপলভ্য প্যারামিটার, স্ট্যাটাস কোড ও ত্রুটি মেসেজ এবং অন্যান্য বিবরণের জন্য Geocoding API ডেভেলপার গাইড দেখুন।
Geocoding API ডেভেলপার নির্দেশিকা, Geocoding API ওয়েব পরিষেবা সম্পর্কে বর্ণনা করে। এটি সেইসব ওয়েবসাইট ও মোবাইল ডেভেলপারদের জন্য যারা Google Maps Platform-এর API-এর মাধ্যমে প্রদান করা ম্যাপের মধ্যে জিওকোডিং ডেটা ব্যবহার করতে চান।