প্লেস জিওকোডিং আপনাকে একটি প্লেস আইডি থেকে ঠিকানা খুঁজে বের করতে সাহায্য করে।
প্লেস আইডি গুগল প্লেসেস ডেটাবেস এবং গুগল ম্যাপসে একটি স্থানকে অনন্যভাবে শনাক্ত করে। কোনো ঠিকানা জিওকোড করার সময় প্লেস আইডি পুনরুদ্ধার করুন। এছাড়াও আপনি প্লেস ডিটেইলস (নতুন) , টেক্সট সার্চ (নতুন) , এবং নিয়ারবাই সার্চ (নতুন) -এর মতো আরও অনেক এপিআই থেকে একটি প্লেস আইডি পুনরুদ্ধার করতে পারেন।
জিওকোডিং অনুরোধগুলি রাখুন
একটি স্থান ভূ-কোডিং অনুরোধ হলো নিম্নলিখিত ফর্মের একটি HTTP GET অনুরোধ:
https://geocode.googleapis.com/v4beta/geocode/places/PLACE_ID
যেখানে PLACE_ID কাঙ্ক্ষিত স্থানটির প্লেস আইডি থাকে।
অন্যান্য সমস্ত প্যারামিটার URL প্যারামিটার হিসাবে পাঠান অথবা, API কী বা ফিল্ড মাস্কের মতো প্যারামিটারগুলো GET অনুরোধের অংশ হিসাবে হেডারে পাঠান। উদাহরণস্বরূপ:
https://geocode.googleapis.com/v4beta/geocode/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?key=API_KEY
অথবা কার্ল কমান্ডে:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ "https://geocode.googleapis.com/v4beta/geocode/places/ChIJj61dQgK6j4AR4GeTYWZsKWw"
অনুরোধ করতে OAuth ব্যবহার করুন
জিওকোডিং এপিআই ভি৪ প্রমাণীকরণের জন্য ওঅথ ২.০ সমর্থন করে। জিওকোডিং এপিআই-এর সাথে ওঅথ ব্যবহার করতে হলে, ওঅথ টোকেনটিকে অবশ্যই সঠিক স্কোপ প্রদান করতে হবে। স্থানভিত্তিক জিওকোডিং-এর জন্য জিওকোডিং এপিআই নিম্নলিখিত স্কোপগুলো সমর্থন করে:
-
https://www.googleapis.com/auth/maps-platform.geocode— সকল জিওকোডিং এপিআই পদ্ধতির সাথে ব্যবহার করুন। -
https://www.googleapis.com/auth/maps-platform.geocode.place— স্থান ভূ-কোডিংয়ের জন্য শুধুমাত্রGeocodePlaceসাথে ব্যবহার করুন।
এছাড়াও, আপনি সমস্ত জিওকোডিং এপিআই মেথডের জন্য সাধারণ https://www.googleapis.com/auth/cloud-platform স্কোপটি ব্যবহার করতে পারেন। এই স্কোপটি ডেভেলপমেন্টের সময় উপযোগী, কিন্তু প্রোডাকশনের জন্য নয়, কারণ এটি একটি সাধারণ স্কোপ যা সমস্ত মেথডে অ্যাক্সেস দেয়।
আরও তথ্য ও উদাহরণের জন্য, Use OAuth দেখুন।
স্থান ভূ-কোডিং প্রতিক্রিয়া
স্থান জিওকোডিং একটি GeocodeResult অবজেক্ট ফেরত দেয়, যা স্থান আইডি-র সাথে সম্পর্কিত স্থানটিকে উপস্থাপন করে।
সম্পূর্ণ 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— যে স্থানের পাঠযোগ্য ঠিকানা আপনি পেতে চান, এটি সেই স্থানের প্লেস আইডি। প্লেস আইডি হলো একটি অনন্য শনাক্তকারী যা অন্যান্য গুগল এপিআই-এর সাথে ব্যবহার করা যায়। উদাহরণস্বরূপ, একটি স্ন্যাপ করা পয়েন্টের ঠিকানা পেতে আপনি রোডস এপিআই দ্বারা প্রাপ্তplaceIDব্যবহার করতে পারেন। প্লেস আইডি সম্পর্কে আরও তথ্যের জন্য, প্লেস আইডি বিভাগটি দেখুন।
ঐচ্ছিক পরামিতি
ভাষা কোড
যে ভাষায় ফলাফল ফেরত দেওয়া হয়।
- সমর্থিত ভাষাগুলোর তালিকা দেখুন। গুগল প্রায়শই সমর্থিত ভাষাগুলো হালনাগাদ করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।
-
languageCodeসরবরাহ করা না হলে, API ডিফল্টরূপেenব্যবহার করে। আপনি যদি একটি অবৈধ ভাষা কোড নির্দিষ্ট করেন, তাহলে API একটিINVALID_ARGUMENTত্রুটি ফেরত দেয়। - এপিআইটি ব্যবহারকারী এবং স্থানীয় বাসিন্দা উভয়ের জন্য পাঠযোগ্য একটি রাস্তার ঠিকানা প্রদান করার জন্য যথাসাধ্য চেষ্টা করে। সেই লক্ষ্য অর্জনের জন্য, এটি পছন্দের ভাষাটি অনুসরণ করে রাস্তার ঠিকানাগুলো স্থানীয় ভাষায় ফেরত দেয় এবং প্রয়োজনে ব্যবহারকারীর পাঠযোগ্য লিপিতে তা প্রতিবর্ণীকরণ করে। অন্য সব ঠিকানা পছন্দের ভাষাতেই ফেরত দেওয়া হয়। ঠিকানার সমস্ত উপাদান একই ভাষায় ফেরত দেওয়া হয়, যা প্রথম উপাদানটি থেকে বেছে নেওয়া হয়।
- পছন্দের ভাষায় কোনো নাম উপলব্ধ না থাকলে, এপিআই সবচেয়ে কাছাকাছি মিল থাকা নামটি ব্যবহার করে।
- পছন্দের ভাষাটি এপিআই দ্বারা ফেরত দেওয়া ফলাফলের সেট এবং সেগুলোর ফেরত দেওয়ার ক্রমের উপর সামান্য প্রভাব ফেলে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপগুলোকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার প্রকারের সংক্ষিপ্ত রূপ, বা এমন প্রতিশব্দ যা একটি ভাষায় বৈধ হলেও অন্য ভাষায় নয়।
অঞ্চল কোড
অঞ্চল কোডটি একটি দুই-অক্ষরের CLDR কোড মান। এর কোনো ডিফল্ট মান নেই। বেশিরভাগ CLDR কোড ISO 3166-1 কোডের অনুরূপ।
কোনো ঠিকানা জিওকোড করার সময় (ফরওয়ার্ড জিওকোডিং) , এই প্যারামিটারটি নির্দিষ্ট অঞ্চলের জন্য পরিষেবা থেকে প্রাপ্ত ফলাফলকে প্রভাবিত করতে পারে, কিন্তু সম্পূর্ণরূপে সীমাবদ্ধ করতে পারে না। কোনো অবস্থান বা স্থান জিওকোড করার সময় (রিভার্স জিওকোডিং বা প্লেস জিওকোডিং) , এই প্যারামিটারটি ঠিকানাটিকে ফরম্যাট করার জন্য ব্যবহার করা যেতে পারে। সব ক্ষেত্রেই, এই প্যারামিটারটি প্রযোজ্য আইনের উপর ভিত্তি করে ফলাফলকে প্রভাবিত করতে পারে।