প্লেস জিওকোডিংয়ের মাধ্যমে আপনি প্লেস আইডি থেকে ঠিকানা পেতে পারেন।
প্লেস আইডি 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-এর দেওয়া উত্তরে GeocodeResult-এর মধ্যে দুটি প্রধান জায়গায় types অ্যারে থাকে:
GeocodeResult.types: এই অ্যারে ফলাফলের সামগ্রিক ধরন নির্দেশ করে। সম্ভাব্য ভ্যালুগুলি Places API-এর ব্যবহার করা জায়গার ধরন থেকে নেওয়া হয়। আরও তথ্যের জন্য, জায়গার ধরন সংক্রান্ত টেবিল ক ও খ দেখুন।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" }
আরও তথ্যের জন্য ফেরত দেওয়ার জন্য ফিল্ড বেছে নিন দেখুন।