Geocoding API v4 হল এমন একটি পরিষেবা যা ঠিকানা ও স্থান আইডির জিওকোডিং, রিভার্স জিওকোডিং এবং গন্তব্য সংক্রান্ত তথ্য প্রদান করে।
জিওকোডিং হল এমন একটি প্রসেস যার মাধ্যমে ঠিকানা (যেমন, রাস্তার ঠিকানা) থেকে ভৌগোলিক কোঅর্ডিনেট (যেমন, অক্ষাংশ ও দ্রাঘিমাংশ) কনভার্ট করা হয়, যা আপনি ম্যাপে মার্কার প্লেস করতে বা ম্যাপের পজিশন সেট করতে ব্যবহার করতে পারেন।
রিভার্স জিওকোডিং হল ভৌগোলিক স্থানাঙ্ককে মানুষের-পঠনযোগ্য ঠিকানায় পরিবর্তন করার প্রসেস।
এছাড়াও, আপনি Geocoding API ব্যবহার করে কোনও
নির্দিষ্ট প্লেস আইডির ঠিকানা খুঁজে পেতে এবং SearchDestinations পদ্ধতির সাহায্যে বিভিন্ন গন্তব্য সম্পর্কে বিস্তারিত তথ্য পেতে পারেন।
অনুরোধ ও উত্তরের নমুনা
আপনি HTTP ইন্টারফেসের মাধ্যমে Geocoding API অ্যাক্সেস করেন। নিচে জিওকোডিং ও রিভার্স জিওকোডিং অনুরোধের উদাহরণ দেওয়া হল।
জিওকোডিং অনুরোধ ও উত্তর (অক্ষাংশ/দ্রাঘিমাংশ লুকআপ)
নিম্নলিখিত উদাহরণে "1600 Amphitheatre Parkway, Mountain View, CA"-এর অক্ষাংশ ও দ্রাঘিমাংশ জানতে চাওয়া হয়েছে এবং উল্লেখ করা হয়েছে যে আউটপুট JSON ফর্ম্যাটে হতে হবে।
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
আপনার ওয়েব ব্রাউজারে URL লিখে এটি পরীক্ষা করতে পারবেন (YOUR_API_KEY-এর জায়গায়
আপনার আসল API key লিখতে ভুলবেন না)।
উত্তরে ঠিকানার অক্ষাংশ ও দ্রাঘিমাংশ উল্লেখ করা হয়েছে।
ডেভেলপার নির্দেশিকা দেখুন, যাতে জিওকোডিং অনুরোধ URL তৈরি করা, উপলভ্য প্যারামিটার এবং উত্তর বোঝা সম্পর্কে আরও তথ্য পাবেন।
নিচে JSON-এ একটি স্যাম্পেল জিওকোডিং রেসপন্স দেওয়া হল:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ", "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ", "location": { "latitude": 37.4438238, "longitude": -122.0869895 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.4424748197085, "longitude": -122.0883384802915 }, "high": { "latitude": 37.445172780291493, "longitude": -122.08564051970852 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043-1351", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] }, { "longText": "1351", "shortText": "1351", "types": [ "postal_code_suffix" ] } ], "types": [ "premise", "street_address" ] } ] }
রিভার্স জিওকোডিং সংক্রান্ত অনুরোধ ও উত্তর (ঠিকানা খোঁজা)
নিম্নলিখিত উদাহরণে মার্কিন যুক্তরাষ্ট্রের নিউইয়র্কের ব্রুকলিনের অক্ষাংশ/দ্রাঘিমাংশ অনুযায়ী ঠিকানা চাওয়া হয়েছে। এতে উল্লেখ করা হয়েছে যে আউটপুট JSON ফর্ম্যাটে হতে হবে।
https://geocode.googleapis.com/v4/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEYআপনার ওয়েব ব্রাউজারে URL লিখে এটি পরীক্ষা করতে পারবেন ('YOUR_API_KEY' সরিয়ে আপনার আসল API key লিখতে ভুলবেন না)। উত্তরে অক্ষাংশ ও দ্রাঘিমাংশের জন্য মানুষের-পঠনযোগ্য ঠিকানা লোকেশন অন্তর্ভুক্ত।
ডেভেলপার নির্দেশিকা দেখুন এগুলি সম্পর্কে আরও তথ্য পেতে: রিভার্স জিওকোডিং অনুরোধ URL তৈরি করা, উপলভ্য প্যারামিটার, এবং উত্তর বোঝা।
নিচে JSON ফর্ম্যাটে রিভার্স জিওকোডিংয়ের একটি নমুনা উত্তর দেওয়া হল:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "location": { "latitude": 37.4225657, "longitude": -122.08465439999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.421214719708509, "longitude": -122.08603273029148 }, "high": { "latitude": 37.423912680291508, "longitude": -122.0833347697085 } }, "bounds": { "low": { "latitude": 37.4225178, "longitude": -122.08484599999998 }, "high": { "latitude": 37.422609600000008, "longitude": -122.0845215 } }, "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "Google Building 40", "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "Google Building 40", "shortText": "Google Building 40", "types": [ "premise" ], "languageCode": "en" }, { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] } ], "types": [ "street_address", "subpremise" ] }, ... Additional results truncated in this example[] ... }
যাচাইকরণ, কোটা, দাম ও নীতি
যাচাইকরণ
Geocoding API ব্যবহার করতে হলে, আপনাকে প্রথমে API চালু করতে হবে এবং সঠিক যাচাইকরণ ক্রেডেনশিয়াল পেতে হবে। আরও তথ্যের জন্য, Google Maps Platform ব্যবহার করা শুরু করুন দেখুন।
কোটা ও দাম
Geocoding API-এর জন্য সেট করা কোটা ও দামের ব্যাপারে বিস্তারিত জানতে ব্যবহার ও বিলিং পৃষ্ঠা পর্যালোচনা করুন।
নীতি
Geocoding API-এর ব্যবহার অবশ্যই API নীতি অনুযায়ী হতে হবে।