Geocoding API v4 দুটি মূল ক্ষমতা প্রদান করে: সমৃদ্ধ হাইপারলোকাল অ্যাট্রিবিউটের জন্য গন্তব্য সার্চ এবং মৌলিক জিওকোডিং (স্থানাঙ্ক-ঠিকানা রূপান্তর)। কোন পদ্ধতি ব্যবহার করবেন তা বুঝতে পারছেন না? জিওকোডিং পদ্ধতি বেছে নিন দেখুন।
- গন্তব্য সার্চ করা (
SearchDestinations): কোনও গন্তব্যে পৌঁছানোর বিস্তারিত তথ্য প্রদান করে—যার মধ্যে রয়েছে বিল্ডিংয়ের প্রবেশপথ, রুট করা যায় এমন নেভিগেশন পয়েন্ট, বিল্ডিং/গ্রাউন্ডের আউটলাইন, সাব-ডেস্টিনেশন এবং কাছাকাছি ল্যান্ডমার্ক। - জিওকোডিং (
GeocodeAddress): রাস্তার ঠিকানাকে অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্কে পরিবর্তন করে যাতে বেসিক মার্কার প্লেস করা বা ম্যাপকে কেন্দ্রে আনা যায়। - রিভার্স জিওকোডিং (
GeocodeLocation): ভৌগোলিক স্থানাঙ্ককে মানুষের-পঠনযোগ্য রাস্তার ঠিকানায় পরিবর্তন করে। - জায়গার জিওকোডিং (
GeocodePlace): পরিচিত কোনও জায়গা আইডির জন্য ফর্ম্যাট করা ঠিকানা ও কোঅর্ডিনেট খুঁজে বের করে।
অনুরোধ ও উত্তরের নমুনা
আপনি HTTP ইন্টারফেসের মাধ্যমে Geocoding API অ্যাক্সেস করেন। গন্তব্য সার্চ করা, ফরওয়ার্ড জিওকোডিং এবং রিভার্স জিওকোডিং-এর জন্য কুইকস্টার্ট উদাহরণ নিচে দেওয়া হল।
গন্তব্য সার্চ করার অনুরোধ ও উত্তর (হাইপারলোকাল পৌঁছানোর ডেটা)
নিম্নলিখিত উদাহরণটি "১৬০০ অ্যাম্ফিথিয়েটার পার্কওয়ে, মাউন্টেন ভিউ, ক্যালিফোর্নিয়া"-এর জন্য SearchDestinations-এ HTTP POST অনুরোধ পাঠায়। মনে রাখবেন যে SearchDestinations-এর জন্য একটি X-Goog-FieldMask হেডার প্রয়োজন যা ফেরত দেওয়ার জন্য ফিল্ডগুলি নির্দিষ্ট করে:
curl -X POST -d '{ "addressQuery": { "addressQuery": "1600 Amphitheatre Parkway, Mountain View, CA" } }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-FieldMask: destinations.primary.displayName,destinations.primary.formattedAddress,destinations.primary.location,destinations.primary.displayPolygon,destinations.entrances,destinations.navigationPoints,destinations.landmarks' \ -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4/geocode/destinations"
নিচে একটি স্যাম্পেল SearchDestinations উত্তর দেওয়া হল যেখানে বিল্ডিং ফুটপ্রিন্ট পলিগন, পছন্দের প্রবেশপথ, রুট করা যায় এমন নেভিগেশন পয়েন্ট এবং কাছাকাছি ল্যান্ডমার্ক দেখানো হয়েছে:
{ "destinations": [ { "primary": { "displayName": { "text": "Googleplex", "languageCode": "en" }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "location": { "latitude": 37.4220656, "longitude": -122.0840897 }, "displayPolygon": { "type": "Polygon", "coordinates": [ [ [-122.084958, 37.422145], [-122.084112, 37.422610], [-122.083510, 37.421980], [-122.084958, 37.422145] ] ] } }, "entrances": [ { "location": { "latitude": 37.422189, "longitude": -122.084215 }, "tags": ["PREFERRED"] } ], "navigationPoints": [ { "navigationPointToken": "Eg...", "displayName": { "text": "Amphitheatre Pkwy Dropoff", "languageCode": "en" }, "location": { "latitude": 37.421912, "longitude": -122.084301 }, "travelModes": ["DRIVE"], "usages": ["DROPOFF", "PICKUP"] } ], "landmarks": [ { "place": { "displayName": { "text": "Charleston Park", "languageCode": "en" } }, "relationalDescription": { "text": "Adjacent to Charleston Park", "languageCode": "en" }, "straightLineDistanceMeters": 85.4 } ] } ] }
জিওকোডিং সংক্রান্ত অনুরোধ ও উত্তর (অক্ষাংশ/দ্রাঘিমাংশ লুক-আপ)
The following example requests the latitude and longitude of "1600 Amphitheatre Parkway, Mountain View, CA", and specifies that the output must be in JSON format.
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 নীতি অনুযায়ী হতে হবে।