প্লেস জিওকোডিং আপনাকে প্লেস আইডি থেকে ঠিকানা ফিরিয়ে আনতে দেয়।
প্লেস আইডি Google Places ডেটাবেস এবং Google Maps-এ কোনও জায়গাকে অনন্যভাবে শনাক্ত করে। আপনি কোনও ঠিকানা জিওকোড করলে, জায়গার আইডি ফিরিয়ে আনুন। এছাড়াও, আপনি অন্যান্য অনেক API থেকে জায়গার আইডি পেতে পারেন, যেমন জায়গার বিবরণ (নতুন), টেক্সট সার্চ (নতুন) এবং নিয়ারবাই সার্চ (নতুন)।
জিওকোডিং সংক্রান্ত অনুরোধ করা
প্লেস জিওকোডিং অনুরোধ হল এই ফর্ম্যাটে একটি HTTP GET অনুরোধ:
https://geocode.googleapis.com/v4/geocode/places/PLACE_ID
যেখানে PLACE_ID-এ প্রাসঙ্গিক লোকেশনের প্লেস আইডি থাকে।
URL প্যারামিটার হিসেবে অন্য সব প্যারামিটার পাস করুন অথবা API কী বা ফিল্ড মাস্কের মতো প্যারামিটারের জন্য, GET অনুরোধের অংশ হিসেবে হেডারে পাস করুন। যেমন:
https://geocode.googleapis.com/v4/geocode/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?key=API_KEY
অথবা curl কমান্ডে:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ "https://geocode.googleapis.com/v4/geocode/places/ChIJj61dQgK6j4AR4GeTYWZsKWw"
অনুরোধ করতে OAuth ব্যবহার করুন
Geocoding API v4 যাচাইকরণের জন্য OAuth 2.0-কে সাপোর্ট করে। Geocoding API-এর সাথে OAuth ব্যবহার করতে, OAuth টোকেনকে অবশ্যই সঠিক স্কোপ অ্যাসাইন করতে হবে। Geocoding API, জায়গার জিওকোডিংয়ের সাথে ব্যবহারের জন্য নিম্নলিখিত স্কোপ সমর্থন করে:
https://www.googleapis.com/auth/maps-platform.geocode— সব Geocoding API পদ্ধতির সাথে ব্যবহার করুন।https://www.googleapis.com/auth/maps-platform.geocode.place— জায়গার জিওকোডিংয়ের জন্য শুধুGeocodePlace-এর সাথে ব্যবহার করুন।
এছাড়াও, আপনি সব Geocoding API পদ্ধতির জন্য সাধারণ https://www.googleapis.com/auth/cloud-platform
স্কোপ ব্যবহার করতে পারবেন। ডেভেলপমেন্টের সময় এই স্কোপ উপযোগী,
কিন্তু প্রোডাকশনের সময় নয়, কারণ এটি একটি সাধারণ স্কোপ যা সব
পদ্ধতিতে অ্যাক্সেস দেয়।
আরও তথ্য ও উদাহরণের জন্য, OAuth ব্যবহার করুন দেখুন।
জিওকোডিং সংক্রান্ত উত্তর দিন
প্লেস জিওকোডিং একটি
GeocodeResult
অবজেক্ট রিটার্ন করে যা প্লেস আইডির সাথে সংশ্লিষ্ট জায়গাকে দেখায়।
Geocoding API রেসপন্সে types অ্যারে অন্তর্ভুক্ত থাকে যা
GeocodeResult-এর মধ্যে দুটি প্রধান জায়গায় থাকে:
GeocodeResult.types: এই অ্যারে ফলাফলের সামগ্রিক ধরন নির্দেশ করে। Places API-এর মাধ্যমে ব্যবহৃত জায়গার ধরন থেকে সম্ভাব্য ভ্যালু নেওয়া হয়। আরও তথ্যের জন্য, জায়গার ধরন টেবিল A এবং B দেখুন।GeocodeResult.addressComponents[].types: প্রতিটি অ্যাড্রেস কম্পোনেন্টে একটিtypesঅ্যারে থাকে যা অ্যাড্রেসের সেই নির্দিষ্ট অংশের ধরন নির্দেশ করে। এই ভ্যালুগুলি Places API-এর ব্যবহার করা ঠিকানার ধরন ও ঠিকানার কম্পোনেন্ট ধরনের টেবিল থেকে নেওয়া হয়েছে।
সম্পূর্ণ JSON অবজেক্টটি এই ফর্ম্যাটে থাকে:
{ "place": "//places.googleapis.com/places/ChIJj61dQgK6j4AR4GeTYWZsKWw", "placeId": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "location": { "latitude": 37.4220541, "longitude": -122.08532419999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.4209489697085, "longitude": -122.08846930000001 }, "high": { "latitude": 37.4236469302915, "longitude": -122.0829156 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043", "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" ] } ], "types": [ "establishment", "point_of_interest" ] }
প্রয়োজনীয় প্যারামিটার
place— যে জায়গার জন্য আপনি মানুষের-পঠনযোগ্য ঠিকানা পেতে চান, সেই জায়গার আইডি। জায়গার আইডি হল একটি অনন্য শনাক্তকারী যা অন্যান্য Google API-এর সাথে ব্যবহার করা যেতে পারে। যেমন, আপনি Roads API-এর মাধ্যমে ফেরত পাওয়াplaceIDব্যবহার করে স্ন্যাপ করা পয়েন্টের ঠিকানা পেতে পারেন। প্লেস আইডি সম্পর্কে আরও জানতে, প্লেস আইডি দেখুন।
ঐচ্ছিক প্যারামিটার
languageCode
যে ভাষায় ফলাফল দেখানো হবে।
- অনুমোদিত ভাষার তালিকা দেখুন। Google প্রায়ই কাজ করে এমন ভাষার তালিকা আপডেট করে, তাই এই তালিকা সম্পূর্ণ নাও হতে পারে।
-
languageCodeপ্রদান করা না হলে, API ডিফল্ট হিসেবে লোকেশনের স্থানীয় ভাষা ও স্ক্রিপ্ট ব্যবহার করে। আপনি যদি কোনও ভুল ভাষার কোড উল্লেখ করেন, তাহলে API একটিINVALID_ARGUMENTত্রুটি দেখায়। - API এমন রাস্তার ঠিকানা প্রদান করার যথাসাধ্য চেষ্টা করে যা ব্যবহারকারী ও স্থানীয় লোকজন উভয়ের জন্যই বোধগম্য হয়। এই লক্ষ্য পূরণ করতে, এটি স্থানীয় ভাষায় রাস্তার ঠিকানা ফেরত পাঠায়, যা ব্যবহারকারীর পছন্দের ভাষা অনুযায়ী, প্রয়োজনে ব্যবহারকারীর পড়ার উপযোগী স্ক্রিপ্টে লিপ্যন্তর করা হয়। অন্যান্য সব ঠিকানা পছন্দের ভাষায় দেখানো হয়। ঠিকানার সব কম্পোনেন্ট একই ভাষায় দেখানো হয়, যা প্রথম কম্পোনেন্ট থেকে বেছে নেওয়া হয়।
- পছন্দের ভাষায় কোনও নাম উপলভ্য না থাকলে, API সবচেয়ে কাছাকাছি ম্যাচ ব্যবহার করে।
- API যে ফলাফল দেখায় এবং যে ক্রমে দেখায়, তার উপর পছন্দের ভাষার সামান্য প্রভাব থাকে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার প্রকারের সংক্ষিপ্ত রূপ, বা সমার্থক শব্দ যা একটি ভাষায় বৈধ হতে পারে কিন্তু অন্য ভাষায় নয়।
regionCode
অঞ্চল কোড দুই-অক্ষরের CLDR কোড ভ্যালু হিসেবে। কোনও ডিফল্ট ভ্যালু নেই। অধিকাংশ CLDR কোড ISO 3166-1 কোডের মতোই।
কোনও ঠিকানা জিওকোড করার সময়, ফরওয়ার্ড জিওকোডিং, এই প্যারামিটার নির্দিষ্ট অঞ্চলের জন্য পরিষেবা থেকে প্রাপ্ত ফলাফলকে প্রভাবিত করতে পারে, তবে সম্পূর্ণরূপে সীমাবদ্ধ করতে পারে না। কোনও লোকেশন বা জায়গার জিওকোডিং, রিভার্স জিওকোডিং বা জায়গার জিওকোডিং করার সময়, ঠিকানা ফর্ম্যাট করতে এই প্যারামিটার ব্যবহার করা যেতে পারে। সব ক্ষেত্রেই, এই প্যারামিটার প্রযোজ্য আইনের ভিত্তিতে ফলাফলকে প্রভাবিত করতে পারে।
-
FieldMask
উত্তরে কোন কোন ফিল্ড ফেরত দেওয়া হবে তা নির্দিষ্ট করতে রেসপন্স ফিল্ড মাস্ক তৈরি করুন। URL প্যারামিটার
$fieldsবাfieldsঅথবা HTTP হেডারX-Goog-FieldMaskব্যবহার করে পদ্ধতিতে রেসপন্স ফিল্ড মাস্ক পাস করুন। যেমন, নিচের অনুরোধটি উত্তরের শুধুমাত্রformattedAddressফিল্ডটি ফিরিয়ে দেবে।curl -X GET -H 'Content-Type: application/json' \ -H 'X-Goog-FieldMask: formattedAddress' \ -H "X-Goog-Api-Key: API_KEY" \ "https://geocode.googleapis.com/v4/geocode/places/ChIJj61dQgK6j4AR4GeTYWZsKWw"
{ "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA" }
আরও বিবরণের জন্য ফেরত দেওয়ার জন্য ফিল্ড বেছে নিন দেখুন।