জিওকোডিং একটি ঠিকানাকে মানচিত্রের একটি অবস্থানে রূপান্তরিত করে। যখন আপনি একটি ঠিকানা জিওকোড করেন, তখন প্রাপ্ত উত্তরে নিম্নলিখিত বিষয়গুলো থাকে:
- অবস্থানের আইডি
- অবস্থানটির অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক
- অবস্থানের প্লাস কোড
- বিস্তারিত ঠিকানা বিবরণ
জিওকোড অনুরোধ
একটি জিওকোড অনুরোধ হলো একটি HTTP GET অনুরোধ। আপনি ঠিকানাটি একটি অসংগঠিত স্ট্রিং হিসাবে নির্দিষ্ট করতে পারেন:
https://geocode.googleapis.com/v4/geocode/address/ADDRESS_STRING
অথবা কোয়েরি প্যারামিটার দ্বারা উপস্থাপিত ঠিকানার উপাদানগুলির একটি কাঠামোগত সেট হিসাবে:
https://geocode.googleapis.com/v4/geocode/address?STRUCTURED_ADDRESS
এইচটিএমএল ফর্মে ধারণ করা ঠিকানার উপাদানগুলো প্রক্রিয়াকরণের সময় আপনি সাধারণত স্ট্রাকচার্ড ফরম্যাট ব্যবহার করেন।
অন্যান্য সমস্ত প্যারামিটার URL প্যারামিটার হিসাবে পাঠান অথবা, API কী এবং ফিল্ড মাস্কের মতো প্যারামিটারগুলো GET অনুরোধের অংশ হিসাবে হেডারে পাঠান।
একটি অসংগঠিত ঠিকানা স্ট্রিং পাস করুন
একটি অসংগঠিত ঠিকানা হলো এমন একটি ঠিকানা যা একটি স্ট্রিং বা প্লাস কোড হিসাবে ফরম্যাট করা থাকে। ঠিকানা জিওকোডিং অক্ষাংশ এবং দ্রাঘিমাংশের স্থানাঙ্ক, অথবা অন্যান্য অসংগঠিত স্ট্রিং যা কোনো ঠিকানা বা প্লাস কোডকে প্রতিনিধিত্ব করে না, সেগুলোকে শনাক্ত করতে পারে না। এই ধরনের স্ট্রিং ব্যবহার করে করা অনুরোধগুলি সমর্থিত নয় এবং এর ফলে ত্রুটিপূর্ণ প্রতিক্রিয়া বা অনির্দিষ্ট আচরণ দেখা দিতে পারে। অসমর্থিত কোয়েরিগুলির উদাহরণ নিচে দেওয়া হলো:
| কোয়েরি টাইপ | উদাহরণ |
|---|---|
| অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক। এর পরিবর্তে বিপরীত জিওকোডিং ব্যবহার করুন। | "৩৭.৪২২১৩১,-১২২.০৮৪৮০১" |
| একটি কোয়েরিতে একাধিক স্থান, রাস্তা বা শহরের নামের মতো অনেক বেশি ধারণা বা সীমাবদ্ধতা। | "মার্কেট স্ট্রিট সান ফ্রান্সিসকো সান হোসে বিমানবন্দর" |
| গুগল ম্যাপে ডাক ঠিকানার যে উপাদানগুলো দেখানো হয় না | "জন স্মিথের তত্ত্বাবধানে, ১২৩ মেইন স্ট্রিট" পোস্ট অফিস বক্স ১৩ সান ফ্রান্সিসকো |
| ব্যবসা, চেইন বা ক্যাটাগরির নাম, সেইসাথে এমন স্থান যেখানে এই সত্তাগুলো উপলব্ধ নয়। | ডালাস, টেক্সাসের নিকটবর্তী টেসকো |
| একাধিক ব্যাখ্যা সহ দ্ব্যর্থক প্রশ্ন | চার্জার ড্রপ-অফ |
| ঐতিহাসিক নাম যা এখন আর ব্যবহৃত হয় না | "মিডলসেক্স যুক্তরাজ্য" |
| অ-ভূস্থানিক উপাদান বা উদ্দেশ্য | ভেনচুরা বন্দরে কয়টি নৌকা আছে? |
| অনানুষ্ঠানিক বা শখের নাম | "জেঙ্গা" "দ্য হেল্টার স্কেল্টার" |
উদাহরণস্বরূপ, নিম্নলিখিত উদাহরণটি URL এনকোডেড ঠিকানা স্ট্রিং "1600 Amphitheatre Parkway, Mountain View, CA" পাস করে:
https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA?key=API_KEY
লক্ষ্য করুন যে URL-এর "+" চিহ্নটি একটি স্পেসে রূপান্তরিত হয়।
আপনি কার্ল (curl) কমান্ড ব্যবহার করেও অনুরোধটি করতে পারেন:
curl -H "X-Goog-Api-Key: API_KEY" \ "https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
ঠিকানায় অনেক ধরনের বিশেষ অক্ষর থাকতে পারে। উদাহরণস্বরূপ, "/" যেমন "7/1 King St, Concord West"। URL এনকোড করার সময় "/" কে %2F হিসেবে লিখুন:
https://geocode.googleapis.com/v4/geocode/address/7%2F1+King+St,+Concord+West?key=API_KEY
আরেকটি সাধারণ উদাহরণ হলো "#" চিহ্নটি, যেমন "9500 W Bryn Mawr Ave #650, Rosemont"। "#" চিহ্নটিকে URL এনকোড করতে %2FE ব্যবহার করুন:
https://geocode.googleapis.com/v4/geocode/address/9500+W+Bryn+Mawr+Ave+%23650,+Rosemont?key=API_KEY
পরবর্তী উদাহরণে, আপনি প্লাস কোড 849VCWC8+R4 হিসেবে একটি অসংগঠিত ঠিকানা স্ট্রিং উল্লেখ করেছেন। নিশ্চিত করুন যে আপনি "+" অক্ষরটিকে %2B হিসেবে URL-এনকোড করেছেন:
https://geocode.googleapis.com/v4/geocode/address/849VCWC8%2BR4?key=API_KEY
একটি কাঠামোগত ঠিকানা পাস করুন
PostalAddress টাইপের address কোয়েরি প্যারামিটার ব্যবহার করে একটি কাঠামোগত ঠিকানা নির্দিষ্ট করুন। PostalAddress অবজেক্টটি আপনাকে অনুরোধে ঠিকানার কিছু বা সমস্ত উপাদানকে পৃথক কোয়েরি প্যারামিটার হিসাবে নির্দিষ্ট করার সুযোগ দেয়।
উদাহরণস্বরূপ, ঠিকানার শুধুমাত্র জিপ কোড নির্দিষ্ট করতে আপনি PostalAddress.postalCode ব্যবহার করেন:
https://geocode.googleapis.com/v4/geocode/address?address.postalCode=01062&key=API_KEY
একাধিক ঠিকানা উপাদান নির্দিষ্ট করতে, যেমন HTML ফর্মে ধারণ করা ঠিকানা উপাদানগুলির জন্য, একাধিক কোয়েরি প্যারামিটার ব্যবহার করুন:
https://geocode.googleapis.com/v4/geocode/address?address.addressLines=1600+Amphithreater+Pkwy&address.locality=Mountain+View &address.administrativeArea=CA &key=API_KEY
অনুরোধ করতে OAuth ব্যবহার করুন
জিওকোডিং এপিআই ভি৪ প্রমাণীকরণের জন্য ওঅথ ২.০ সমর্থন করে। জিওকোডিং এপিআই-এর সাথে ওঅথ ব্যবহার করতে হলে, ওঅথ টোকেনটিকে অবশ্যই সঠিক স্কোপ প্রদান করতে হবে। ফরোয়ার্ড জিওকোডিং-এর জন্য জিওকোডিং এপিআই নিম্নলিখিত স্কোপগুলো সমর্থন করে:
-
https://www.googleapis.com/auth/maps-platform.geocode— সকল জিওকোডিং এপিআই পদ্ধতির সাথে ব্যবহার করুন। -
https://www.googleapis.com/auth/maps-platform.geocode.address— শুধুমাত্র ফরোয়ার্ড জিওকোডিং-এর জন্যGeocodeAddressসাথে ব্যবহার করুন।
এছাড়াও, আপনি সমস্ত জিওকোডিং এপিআই মেথডের জন্য সাধারণ https://www.googleapis.com/auth/cloud-platform স্কোপটি ব্যবহার করতে পারেন। এই স্কোপটি ডেভেলপমেন্টের সময় উপযোগী, কিন্তু প্রোডাকশনের জন্য নয়, কারণ এটি একটি সাধারণ স্কোপ যা সমস্ত মেথডে অ্যাক্সেস দেয়।
আরও তথ্য ও উদাহরণের জন্য, Use OAuth দেখুন।
জিওকোড প্রতিক্রিয়া
জিওকোডিং একটি GeocodeAddressResponse অবজেক্ট রিটার্ন করে, যার মধ্যে GeocodeResult অবজেক্টের একটি results অ্যারে থাকে। প্রতিটি GeocodeResult অবজেক্ট একটিমাত্র স্থানের প্রতিনিধিত্ব করে।
Geocoding API-এর প্রতিক্রিয়াগুলিতে GeocodeResult মধ্যে দুটি প্রধান স্থানে types অ্যারে অন্তর্ভুক্ত থাকে:
-
GeocodeResult.types: এই অ্যারেটি ফলাফলের সামগ্রিক ধরণ নির্দেশ করে। সম্ভাব্য মানগুলো Place Types (New) পৃষ্ঠার টেবিল A এবং টেবিল B থেকে নেওয়া হয়। -
GeocodeResult.addressComponents[].types: ঠিকানার প্রতিটি উপাদানের একটিtypesঅ্যারে থাকে, যা ঠিকানার সেই নির্দিষ্ট অংশের ধরন নির্দেশ করে। এই মানগুলি 'Place Types (New)' পৃষ্ঠার 'Address types' এবং 'address component types' সারণি থেকে নেওয়া হয়।
সম্পূর্ণ JSON অবজেক্টটি নিম্নলিখিত আকারে থাকে:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJF4Yf2Ry7j4AR__1AkytDyAE", "placeId": "ChIJF4Yf2Ry7j4AR__1AkytDyAE", "location": { "latitude": 37.422010799999995, "longitude": -122.08474779999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.420656719708511, "longitude": -122.08547523029148 }, "high": { "latitude": 37.4233546802915, "longitude": -122.0827772697085 } }, "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" }, ... ], "types": [ "street_address" ], "plusCode": { "globalCode": "849VCWC8+R4", "compoundCode": "CWC8+R4 Mountain View, CA, USA" } } ] }
প্রয়োজনীয় প্যারামিটার
-
address— যে রাস্তার ঠিকানা বা প্লাস কোডটি আপনি জিওকোড করতে চান। দ্রষ্টব্য: ঠিকানা জিওকোডিং অক্ষাংশ এবং দ্রাঘিমাংশের স্থানাঙ্ক, বা অন্যান্য অসংগঠিত স্ট্রিং যা কোনো ঠিকানা বা প্লাস কোডকে প্রতিনিধিত্ব করে না, তা সমাধান করে না। আরও বিশদ বিবরণ এবং অসমর্থিত কোয়েরির উদাহরণের জন্য "একটি অসংগঠিত ঠিকানা স্ট্রিং পাস করুন" দেখুন। সংশ্লিষ্ট দেশের জাতীয় ডাক পরিষেবা দ্বারা ব্যবহৃত বিন্যাস অনুসারে ঠিকানা উল্লেখ করুন। ব্যবসার নাম এবং ইউনিট, স্যুট বা ফ্লোর নম্বরের মতো অতিরিক্ত ঠিকানার উপাদানগুলি এড়িয়ে চলা উচিত। রাস্তার ঠিকানার উপাদানগুলিকে%20-তে URL-এনকোড করা স্পেস দ্বারা পৃথক করতে হবে। উদাহরণস্বরূপ, "24 Sussex Drive Ottawa ON" ঠিকানাটি এভাবে পাস করুন: প্লাস কোডগুলো নিচে দেখানো অনুযায়ী ফরম্যাট করুন। প্লাস চিহ্নগুলো URL-encode হয়ে24%20Sussex%20Drive%20Ottawa%20ON
%2Bহয় এবং স্পেসগুলো URL-encode হয়ে%20হয়।- একটি গ্লোবাল কোড হলো ৪ অক্ষরের একটি এরিয়া কোড এবং ৬ বা তার বেশি অক্ষরের একটি লোকাল কোড। উদাহরণস্বরূপ, "849VCWC8+R9" কে
849VCWC8%2BR9হিসাবে এনকোড করুন। - যৌগিক কোড হলো একটি ৬ বা ততোধিক অক্ষরের স্থানীয় কোড, যার সাথে একটি সুস্পষ্ট অবস্থান যুক্ত থাকে। উদাহরণস্বরূপ, "CWC8+R9 Mountain View, CA, USA"
CWC8%2BR9%20Mountain%20View%20CA%20USAহিসেবে এনকোড করুন।
- একটি গ্লোবাল কোড হলো ৪ অক্ষরের একটি এরিয়া কোড এবং ৬ বা তার বেশি অক্ষরের একটি লোকাল কোড। উদাহরণস্বরূপ, "849VCWC8+R9" কে
ঐচ্ছিক পরামিতি
অবস্থানগত পক্ষপাত
Viewportহিসেবে অনুসন্ধানের জন্য একটি এলাকা নির্দিষ্ট করে। এই অবস্থানটি একটি বায়াস হিসেবে কাজ করে, যার অর্থ হলো নির্দিষ্ট অবস্থানের আশেপাশের ফলাফলগুলোও ফেরত দেওয়া হতে পারে, যার মধ্যে এলাকার কাছাকাছি কিন্তু বাইরের ফলাফলও অন্তর্ভুক্ত।অঞ্চলটিকে একটি আয়তক্ষেত্রাকার ভিউপোর্ট হিসেবে নির্দিষ্ট করুন। একটি আয়তক্ষেত্র হলো একটি অক্ষাংশ-দ্রাঘিমাংশ ভিউপোর্ট, যা দুটি তির্যকভাবে বিপরীত নিম্ন ও উচ্চ বিন্দু দ্বারা উপস্থাপিত হয়। নিম্ন বিন্দুটি আয়তক্ষেত্রটির দক্ষিণ-পশ্চিম কোণকে এবং উচ্চ বিন্দুটি উত্তর-পূর্ব কোণকে নির্দেশ করে।
একটি ভিউপোর্টকে একটি বদ্ধ অঞ্চল হিসেবে বিবেচনা করা হয়, যার অর্থ এটি তার সীমানাকে অন্তর্ভুক্ত করে। অক্ষাংশের সীমা অবশ্যই -৯০ থেকে ৯০ ডিগ্রির মধ্যে হতে হবে এবং দ্রাঘিমাংশের সীমা অবশ্যই -১৮০ থেকে ১৮০ ডিগ্রির মধ্যে হতে হবে।
- যদি
low=high, তাহলে ভিউপোর্টটি সেই একক বিন্দুটি নিয়ে গঠিত হয়। - যদি
low.longitude>high.longitude, তাহলে দ্রাঘিমাংশের পরিসরটি উল্টে যায় (ভিউপোর্টটি ১৮০ ডিগ্রি দ্রাঘিমা রেখা অতিক্রম করে)। - যদি
low.longitude= -180 ডিগ্রি এবংhigh.longitude= 180 ডিগ্রি হয়, তাহলে ভিউপোর্টে সমস্ত দ্রাঘিমাংশ অন্তর্ভুক্ত থাকবে। - যদি
low.longitude= 180 ডিগ্রি এবংhigh.longitude= -180 ডিগ্রি হয়, তাহলে দ্রাঘিমাংশের পরিসরটি খালি থাকে। - যদি
low.latitude>high.latitudeহয়, তাহলে অক্ষাংশের পরিসরটি খালি থাকে।
নিম্ন এবং উচ্চ উভয়ই অবশ্যই পূরণ করতে হবে এবং প্রদর্শিত বক্সটি খালি থাকতে পারবে না। একটি খালি ভিউপোর্টের ফলে ত্রুটি দেখা দেয়।
উদাহরণস্বরূপ, এই কোয়েরি স্ট্রিংটি এমন একটি ভিউপোর্ট নির্ধারণ করে যা নিউ ইয়র্ক শহরকে সম্পূর্ণরূপে আবদ্ধ করে:
?locationBias.rectangle.low.latitude=40.477398
&locationBias.rectangle.low.longitude=-74.259087 &locationBias.rectangle.high.latitude=40.91618 &locationBias.rectangle.high.longitude=-73.70018 - যদি
ভাষা কোড
যে ভাষায় ফলাফল ফেরত দেওয়া হয়।
- সমর্থিত ভাষাগুলোর তালিকা দেখুন। গুগল প্রায়শই সমর্থিত ভাষাগুলো হালনাগাদ করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।
-
languageCodeসরবরাহ করা না হলে, API ডিফল্টরূপেenব্যবহার করে। আপনি যদি একটি অবৈধ ভাষা কোড নির্দিষ্ট করেন, তাহলে API একটিINVALID_ARGUMENTত্রুটি ফেরত দেয়। - এপিআইটি ব্যবহারকারী এবং স্থানীয় বাসিন্দা উভয়ের জন্য পাঠযোগ্য একটি রাস্তার ঠিকানা প্রদান করার জন্য যথাসাধ্য চেষ্টা করে। সেই লক্ষ্য অর্জনের জন্য, এটি পছন্দের ভাষাটি অনুসরণ করে রাস্তার ঠিকানাগুলো স্থানীয় ভাষায় ফেরত দেয় এবং প্রয়োজনে ব্যবহারকারীর পাঠযোগ্য লিপিতে তা প্রতিবর্ণীকরণ করে। অন্য সব ঠিকানা পছন্দের ভাষাতেই ফেরত দেওয়া হয়। ঠিকানার সমস্ত উপাদান একই ভাষায় ফেরত দেওয়া হয়, যা প্রথম উপাদানটি থেকে বেছে নেওয়া হয়।
- পছন্দের ভাষায় কোনো নাম উপলব্ধ না থাকলে, এপিআই সবচেয়ে কাছাকাছি মিল থাকা নামটি ব্যবহার করে।
- পছন্দের ভাষাটি এপিআই দ্বারা ফেরত দেওয়া ফলাফলের সেট এবং সেগুলোর ফেরত দেওয়ার ক্রমের উপর সামান্য প্রভাব ফেলে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপগুলোকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার প্রকারের সংক্ষিপ্ত রূপ, বা এমন প্রতিশব্দ যা একটি ভাষায় বৈধ হলেও অন্য ভাষায় নয়।
অঞ্চল কোড
অঞ্চল কোডটি একটি দুই-অক্ষরের CLDR কোড মান। এর কোনো ডিফল্ট মান নেই। বেশিরভাগ CLDR কোড ISO 3166-1 কোডের অনুরূপ।
কোনো ঠিকানা জিওকোড করার সময় (ফরওয়ার্ড জিওকোডিং) , এই প্যারামিটারটি নির্দিষ্ট অঞ্চলের জন্য পরিষেবা থেকে প্রাপ্ত ফলাফলকে প্রভাবিত করতে পারে, কিন্তু সম্পূর্ণরূপে সীমাবদ্ধ করতে পারে না। কোনো অবস্থান বা স্থান জিওকোড করার সময় (রিভার্স জিওকোডিং বা প্লেস জিওকোডিং) , এই প্যারামিটারটি ঠিকানাটিকে ফরম্যাট করার জন্য ব্যবহার করা যেতে পারে। সব ক্ষেত্রেই, এই প্যারামিটারটি প্রযোজ্য আইনের উপর ভিত্তি করে ফলাফলকে প্রভাবিত করতে পারে।
ফিল্ডমাস্ক
রেসপন্সে কোন ফিল্ডগুলো ফেরত আসবে তা নির্দিষ্ট করতে একটি রেসপন্স ফিল্ড মাস্ক তৈরি করুন। URL প্যারামিটার
$fieldsবাfieldsব্যবহার করে, অথবা HTTP হেডারX-Goog-FieldMaskব্যবহার করে রেসপন্স ফিল্ড মাস্কটি মেথডে পাস করুন। উদাহরণস্বরূপ, নিচের রিকোয়েস্টটি রেসপন্সের শুধুমাত্রplaceIDফিল্ডটি ফেরত দেবে। উত্তরটি হলো:curl -X GET -H 'Content-Type: application/json' \ -H 'X-Goog-FieldMask: results.placeId' \ -H "X-Goog-Api-Key: API_KEY" \ https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA
{ "results": [ { "placeId": "ChIJiSSC8QK6j4AR98Thup8mqTc" } ] }
আরও বিস্তারিত তথ্যের জন্য ফেরত দেওয়ার ক্ষেত্র নির্বাচন দেখুন।
অবস্থান পক্ষপাত
একটি নির্দিষ্ট ভিউপোর্টের (বাউন্ডিং বক্স হিসাবে প্রকাশিত) মধ্যে থাকা ফলাফলকে অগ্রাধিকার দিতে জিওকোডিং পরিষেবাটিকে নির্দেশ দেওয়ার জন্য locationBias প্যারামিটারটি ব্যবহার করুন। locationBias প্যারামিটারটি এই বাউন্ডিং বক্সের দক্ষিণ-পশ্চিম এবং উত্তর-পূর্ব কোণার অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক নির্ধারণ করে।
উদাহরণস্বরূপ, 'ওয়াশিংটন' ঠিকানার জন্য একটি জিওকোড অনুরোধ ওয়াশিংটন, ডিসি এবং মার্কিন যুক্তরাষ্ট্রের ওয়াশিংটন অঙ্গরাজ্যের জন্য ফলাফল ফেরত দিতে পারে:
https://geocode.googleapis.com/v4/geocode/address/Washington?key=API_KEY
উত্তরটি নিম্নরূপ:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJW-T2Wt7Gt4kRKl2I1CJFUsI", "placeId": "ChIJW-T2Wt7Gt4kRKl2I1CJFUsI", "location": { "latitude": 38.9071923, "longitude": -77.0368707 }, "granularity": "APPROXIMATE", "viewport": { "low": { "latitude": 38.7916449, "longitude": -77.119759 }, "high": { "latitude": 38.9958641, "longitude": -76.909393 } }, "bounds": { "low": { "latitude": 38.7916449, "longitude": -77.119759 }, "high": { "latitude": 38.9958641, "longitude": -76.909393 } }, "formattedAddress": "Washington, DC, USA", "addressComponents": [ { "longText": "Washington", "shortText": "Washington", "types": [ "locality", "political" ], "languageCode": "en" }, ... ], "types": [ "locality", "political" ] }, { "place": "//places.googleapis.com/places/ChIJ-bDD5__lhVQRuvNfbGh4QpQ", "placeId": "ChIJ-bDD5__lhVQRuvNfbGh4QpQ", "location": { "latitude": 47.7510741, "longitude": -120.7401386 }, "granularity": "APPROXIMATE", "viewport": { "low": { "latitude": 45.543541, "longitude": -124.84897389999999 }, "high": { "latitude": 49.0024945, "longitude": -116.91607109999998 } }, "bounds": { "low": { "latitude": 45.543541, "longitude": -124.84897389999999 }, "high": { "latitude": 49.0024442, "longitude": -116.91607109999998 } }, "formattedAddress": "Washington, USA", "addressComponents": [ { "longText": "Washington", "shortText": "WA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, ... ], "types": [ "administrative_area_level_1", "political" ] } ] }
তবে, মার্কিন যুক্তরাষ্ট্রের উত্তর-পূর্ব অংশের চারপাশে একটি বাউন্ডিং বক্স নির্ধারণকারী একটি locationBias প্যারামিটার যোগ করার ফলে এই জিওকোডটি শুধুমাত্র ওয়াশিংটন, ডিসি শহরটিকে ফেরত দেয়:
https://geocode.googleapis.com/v4/geocode/address/Washington?locationBias.rectangle.low.latitude=36.47&locationBias.rectangle.low.longitude=-84.72 &locationBias.rectangle.high.latitude=43.39 &locationBias.rectangle.high.longitude=-65.90 &key=API_KEY
অঞ্চল পক্ষপাত
একটি জিওকোডিং অনুরোধে, আপনি regionCode প্যারামিটারটি ব্যবহার করে জিওকোডিং পরিষেবাটিকে একটি নির্দিষ্ট অঞ্চলের প্রতি পক্ষপাতদুষ্ট ফলাফল ফেরত দিতে নির্দেশ দিতে পারেন। এই প্যারামিটারটি একটি দুই-অক্ষরের CLDR কোড মান গ্রহণ করে, যা অঞ্চলের পক্ষপাতিত্ব নির্দিষ্ট করে। বেশিরভাগ CLDR কোড ISO 3166-1 কোডের অনুরূপ।
regionCode এর কোনো ডিফল্ট মান নেই। উদাহরণস্বরূপ, "Toledo"-এর জন্য একটি জিওকোড মার্কিন যুক্তরাষ্ট্র এবং স্পেনের জন্য ফলাফল ফেরত দেয়:
https://geocode.googleapis.com/v4/geocode/address/Toledo?key=API_KEY
প্রতিক্রিয়া:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJeU4e_C2HO4gRRcM6RZ_IPHw", "placeId": "ChIJeU4e_C2HO4gRRcM6RZ_IPHw", "location": { "latitude": 41.652805199999996, "longitude": -83.5378674 }, "granularity": "APPROXIMATE", "viewport": { "low": { "latitude": 41.579513, "longitude": -83.6944089 }, "high": { "latitude": 41.733036, "longitude": -83.4493851 } }, "bounds": { "low": { "latitude": 41.579513, "longitude": -83.6944089 }, "high": { "latitude": 41.733036, "longitude": -83.4493851 } }, "formattedAddress": "Toledo, OH, USA", "addressComponents": [ { "longText": "Toledo", "shortText": "Toledo", "types": [ "locality", "political" ], "languageCode": "en" }, ... ], "types": [ "locality", "political" ] }, { "place": "//places.googleapis.com/places/ChIJkwyrlqwLag0RiQIn2fdIshM", "placeId": "ChIJkwyrlqwLag0RiQIn2fdIshM", "location": { "latitude": 39.8628296, "longitude": -4.0273067 }, "granularity": "APPROXIMATE", "viewport": { "low": { "latitude": 39.8116682, "longitude": -4.179933 }, "high": { "latitude": 39.9251319, "longitude": -3.8148935 } }, "bounds": { "low": { "latitude": 39.8116682, "longitude": -4.179933 }, "high": { "latitude": 39.9251319, "longitude": -3.8148935 } }, "formattedAddress": "Toledo, España", "addressComponents": [ { "longText": "Toledo", "shortText": "Toledo", "types": [ "administrative_area_level_4", "political" ], "languageCode": "es" }, ... ], "types": [ "administrative_area_level_4", "political" ] }, ... ] }
regionCode=es (স্পেন) সহ "টলেডো"-র জন্য একটি জিওকোডিং অনুরোধ শুধুমাত্র স্পেন থেকে ফলাফল ফেরত দেয়:
https://geocode.googleapis.com/v4/geocode/address/Toledo?regionCode=es&key=API_KEY