জিওকোডিং API v4 হল এমন একটি পরিষেবা যা জিওকোডিং, ঠিকানা এবং স্থান আইডির বিপরীত জিওকোডিং এবং গন্তব্য তথ্য প্রদান করে।
জিওকোডিং হল ঠিকানাগুলিকে (যেমন রাস্তার ঠিকানা) ভৌগোলিক স্থানাঙ্কে (যেমন অক্ষাংশ এবং দ্রাঘিমাংশ) রূপান্তর করার প্রক্রিয়া, যা আপনি মানচিত্রে মার্কার স্থাপন করতে বা মানচিত্রের অবস্থান নির্ধারণ করতে ব্যবহার করতে পারেন।
রিভার্স জিওকোডিং হলো ভৌগোলিক স্থানাঙ্কগুলিকে মানুষের পাঠযোগ্য ঠিকানায় রূপান্তর করার প্রক্রিয়া।
আপনি একটি নির্দিষ্ট স্থান আইডির ঠিকানা খুঁজে পেতে জিওকোডিং API ব্যবহার করতে পারেন।
নমুনা অনুরোধ এবং প্রতিক্রিয়া
আপনি একটি HTTP ইন্টারফেসের মাধ্যমে জিওকোডিং API অ্যাক্সেস করতে পারেন। জিওকোডিং এবং বিপরীত জিওকোডিং অনুরোধের উদাহরণ নীচে দেওয়া হল।
জিওকোডিং অনুরোধ এবং প্রতিক্রিয়া (অক্ষাংশ/দ্রাঘিমাংশ অনুসন্ধান)
নিম্নলিখিত উদাহরণটি "১৬০০ অ্যাম্ফিথিয়েটার পার্কওয়ে, মাউন্টেন ভিউ, ক্যালিফোর্নিয়া" এর অক্ষাংশ এবং দ্রাঘিমাংশের অনুরোধ করে এবং নির্দিষ্ট করে যে আউটপুটটি অবশ্যই JSON ফর্ম্যাটে হতে হবে।
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
আপনি আপনার ওয়েব ব্রাউজারে URL টি প্রবেশ করিয়ে এটি পরীক্ষা করতে পারেন ( YOUR_API_KEY আপনার আসল API কী দিয়ে প্রতিস্থাপন করতে ভুলবেন না)। প্রতিক্রিয়াটিতে ঠিকানার অক্ষাংশ এবং দ্রাঘিমাংশ অন্তর্ভুক্ত থাকে।
জিওকোডিং অনুরোধ 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/v4beta/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEYআপনি আপনার ওয়েব ব্রাউজারে URL টি প্রবেশ করিয়ে এটি পরীক্ষা করতে পারেন ('YOUR_API_KEY' কে আপনার আসল API কী দিয়ে প্রতিস্থাপন করতে ভুলবেন না)। প্রতিক্রিয়াটিতে অক্ষাংশ এবং দ্রাঘিমাংশ অবস্থানের জন্য একটি মানুষের পাঠযোগ্য ঠিকানা অন্তর্ভুক্ত রয়েছে।
রিভার্স জিওকোডিং অনুরোধ 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[] ... }
প্রমাণীকরণ, কোটা, মূল্য নির্ধারণ এবং নীতিমালা
প্রমাণীকরণ
জিওকোডিং API ব্যবহার করার জন্য, আপনাকে প্রথমে API সক্ষম করতে হবে এবং যথাযথ প্রমাণীকরণ শংসাপত্রগুলি পেতে হবে। আরও তথ্যের জন্য, Google Maps প্ল্যাটফর্ম দিয়ে শুরু করুন দেখুন।
কোটা এবং মূল্য নির্ধারণ
জিওকোডিং API-এর জন্য নির্ধারিত কোটা এবং মূল্য নির্ধারণের বিশদ বিবরণের জন্য ব্যবহার এবং বিলিং পৃষ্ঠাটি পর্যালোচনা করুন।
নীতিমালা
জিওকোডিং API-এর ব্যবহার অবশ্যই API নীতিমালা অনুসারে হতে হবে।