ঠিকানা যাচাইকরণের অনুরোধ পাঠান

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর ডেভেলপার

আপনার বিলিং ঠিকানা ইউরোপীয় অর্থনৈতিক অঞ্চলে হলে, ৮ জুলাই ২০২৫ থেকে কার্যকর, Google Maps Platform EEA পরিষেবার শর্তাবলী আপনার পরিষেবা ব্যবহারের ক্ষেত্রে প্রযোজ্য হবে। অঞ্চল অনুযায়ী কার্যকারিতা আলাদা হয়। আরও জানুন।

নিম্নলিখিত এন্ডপয়েন্টগুলির একটিতে POST অনুরোধ ইস্যু করে ঠিকানা যাচাইকরণের অনুরোধ পাঠান:

• validateAddress (REST)
• ValidateAddress (gRPC)

মনে রাখবেন: এই ডকুমেন্টেশনে উদাহরণের জন্য REST ব্যবহার করা হয়, তবে gRPC-এর ক্ষেত্রেও একই পদ্ধতি ব্যবহার করা হয়।

এছাড়াও, আপনার অনুরোধে একটি JSON অনুরোধ বডি পাস করতে হবে যা যাচাই করার জন্য ঠিকানা নির্ধারণ করে। নিম্নলিখিত অনুরোধের বডিতে একটি ফিল্ড এবং তিনটি সাবফিল্ড আছে:

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:validateAddress?key=API_KEY"

এছাড়াও, আপনি locality বাদ দিতে এবং addressLines অ্যারেতে এলিমেন্ট হিসেবে এটি উল্লেখ করতে পারেন:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

APIs Explorer আপনাকে লাইভ অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পের সাথে পরিচিত হতে পারেন:

এটি ব্যবহার করে দেখুন!

ঠিকানা সংক্রান্ত অনুরোধের ফিল্ড

অনুরোধের প্রধান অংশে একটি ফিল্ড থাকে:

• address — PostalAddress ধরনের ফিল্ড, যাতে addressLines-এ অন্তত একটি এন্ট্রি থাকতেই হবে।

Address Validation API-তে address ফিল্ড পাঠানোর সময়, আপনাকে শুধু একটি ফিল্ড দিতে হবে: addressLines। তবে, সবচেয়ে সহজ অ্যাড্রেস সংক্রান্ত অনুরোধে নিম্নলিখিত সাবফিল্ড থাকতে হবে:

• regionCode — সাজেস্ট করা হয়েছে। এটি একটি ঐচ্ছিক ফিল্ড, তবে বাদ দেওয়া হলে, Address Validation API ঠিকানা থেকে অঞ্চল অনুমান করে। তবে, সেরা ফলাফলের জন্য, regionCode জানা থাকলে তা অন্তর্ভুক্ত করুন। কোন কোন অঞ্চলে এটি কাজ করে তা জানতে, কাজ করে এমন অঞ্চল দেখুন।
• addressLines — আবশ্যক। ঠিকানার নিচের স্ট্রাকচার বর্ণনা করে এমন ঠিকানা সহ অ্যারে।

রেফারেন্স গাইডে PostalAddress দেখুন।

USPS CASS™ বিকল্প

The United States Postal Service® (USPS®)^১ Coding Accuracy Support System (CASS™) বজায় রাখে যাতে ঠিকানা যাচাইকরণ প্রদানকারীদের সহায়তা ও সার্টিফিকেট প্রদান করা যায়।

মনে রাখবেন: Address Validation API-কে CASS-Certified™ পরিষেবা হিসেবে কনফার্ম করা হয়েছে। এর অর্থ হল, এই পরিষেবাটি অনুপস্থিত ঠিকানা সংক্রান্ত তথ্য পূরণ, এটিকে স্ট্যান্ডার্ডাইজ করা এবং এটিকে সবচেয়ে সাম্প্রতিক এবং সঠিক ঠিকানায় আপডেট করার ক্ষমতার জন্য কনফার্ম করা হয়েছে।

শুধুমাত্র মার্কিন যুক্তরাষ্ট্র ও পুয়ের্তো রিকো অঞ্চলের জন্য, অনুরোধের বডিতে enableUspsCass-কে true-এ সেট করে আপনি CASS প্রসেসিং চালু করতে পারবেন। CASS ব্যবহার করার সময় সেরা ফলাফল পেতে, এমন ঠিকানা দিন যাতে রাস্তার নাম ও রাস্তার নম্বর সহ শহর, রাজ্য ও পিন কোড উল্লেখ করা আছে:

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

মনে রাখবেন: আপনার যদি CASS প্রসেসিংয়ের প্রয়োজন না হয় অথবা আপনি যদি মার্কিন যুক্তরাষ্ট্র ও পুয়ের্তো রিকো অঞ্চলের বাইরের ঠিকানা যাচাই করেন, তাহলে Google এই ফিচার চালু করার সাজেশন দেয় না।

এটি ব্যবহার করে দেখুন!

APIs Explorer আপনাকে স্যাম্পেল অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পের সাথে পরিচিত হতে পারেন।

1. পৃষ্ঠার ডানদিকে API আইকন api বেছে নিন।

2. ঐচ্ছিকভাবে, অনুরোধের প্যারামিটার এডিট করুন।

3. এক্সিকিউট করুন বোতামটি বেছে নিন। ডায়ালগে, অনুরোধ করার জন্য আপনি যে অ্যাকাউন্ট ব্যবহার করতে চান সেটি বেছে নিন।

4. APIs Explorer প্যানেলে, APIs Explorer উইন্ডো বড় করতে ফুলস্ক্রিন আইকন ফুলস্ক্রিন বেছে নিন।

---

1. Google Maps Platform হল United States Postal Service®-এর অনন্য নয় এমন লাইসেন্সধারী। নিম্নলিখিত ট্রেডমার্ক(গুলি) United States Postal Service®-এর মালিকানাধীন এবং অনুমতি নিয়ে ব্যবহার করা হয়: United States Postal Service®, CASS™, CASS Certified™। ↩