Address Validation API সংক্রান্ত কুইক রেফারেন্স

Address Validation API কোনও ঠিকানা গ্রহণ করে, এর কম্পোনেন্ট শনাক্ত করে এবং সেগুলি যাচাই করে, মেল করার জন্য ঠিকানাটি স্ট্যান্ডার্ডাইজ করে এবং এর জন্য সবচেয়ে পরিচিত অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট প্রদান করে। মার্কিন যুক্তরাষ্ট্র এবং পুয়ের্তো রিকোর ঠিকানার জন্য, আপনি বিকল্প হিসেবে USPS CASS প্রসেসিং চালু করতে পারেন।

Address Validation API: মূল তথ্য

  • প্রোডাক্ট: Address Validation API
  • বিভাগ: জায়গা
  • প্ল্যাটফর্ম: ওয়েব পরিষেবা (REST)
  • রান করে: সার্ভার (ব্যাকএন্ড কোড)
  • লঞ্চ স্টেজ: GA
  • লাইফসাইকেল: অ্যাক্টিভ
  • এক নজরে: Address Validation API এক নজরে
  • আঞ্চলিক উপলভ্যতা: সীমিত। যেসব দেশে এই সুবিধা কাজ করে এবং ডেটার কোয়ালিটি দেশ অনুযায়ী আলাদা আলাদা হয় এবং কিছু দেশে প্রিভিউতে আছে। শুধুমাত্র কভারেজ পৃষ্ঠায় ফ্ল্যাগ করা দেশের জন্য আবাসিক ও বাণিজ্যিক মেটাডেটা দেখানো হয়। USPS CASS শুধুমাত্র মার্কিন যুক্তরাষ্ট্র ও পুয়ের্তো রিকোর জন্য কাজ করে। (কভারেজ সংক্রান্ত বিবরণ)

Address Validation API: কখন ব্যবহার করবেন

Address Validation API ব্যবহার করুন যখন:

  • কোনও ঠিকানা কোনও আসল জায়গাকে রেফার করছে কিনা তা আপনাকে চেক করতে হবে এবং কোন কম্পোনেন্ট অনুপস্থিত বা ভুল হতে পারে তা খুঁজে বের করতে হবে।
  • আপনাকে মেল করার জন্য একটি ঠিকানা স্ট্যান্ডার্ডাইজ এবং সম্পূর্ণ করতে হবে, যেমন চেক-আউট ফ্লো চলাকালীন।
  • মার্কিন যুক্তরাষ্ট্র বা পুয়ের্তো রিকোর ঠিকানার জন্য আপনার USPS CASS-সার্টিফায়েড যাচাইকরণ এবং uspsData প্রয়োজন।
  • কভারেজ পৃষ্ঠায় তালিকাভুক্ত কোনও দেশের জন্য আপনার আবাসিক বা বাণিজ্যিক ঠিকানার মেটাডেটা প্রয়োজন।

Address Validation API ব্যবহার করবেন না যখন:

  • আপনাকে শুধু ঠিকানা অক্ষাংশ/দ্রাঘিমাংশে কনভার্ট করতে হবে এবং ঠিকানার আলাদা আলাদা অংশ যাচাই করতে হবে না। পরিবর্তে Geocoding API ব্যবহার করুন।
  • আপনার হাইপার-লোকাল গন্তব্যের বিবরণ যেমন বিল্ডিংয়ের প্রবেশপথ, বিল্ডিংয়ের আউটলাইন বা নেভিগেশন পয়েন্ট প্রয়োজন। পরিবর্তে Geocoding API ব্যবহার করুন।

Address Validation API: সেট-আপ

অফিসিয়াল Address Validation API প্যাকেজ:

  • npm: @googlemaps/addressvalidation
  • pypi: google-maps-addressvalidation
  • যান: cloud.google.com/go/maps

Address Validation API: সাধারণ ভুল

  • সমস্যা: addressComplete প্রপার্টির ভ্যালু false হলে, সেটি রায় থেকে বাদ দেওয়া হয়, তাই যে কোড ফিল্ডটি উপস্থিত থাকবে বলে আশা করে, সেটি অসম্পূর্ণ ঠিকানা ভুলভাবে পড়তে পারে। সমাধান: উল্লেখ না থাকা addressComplete প্রপার্টিকে false হিসেবে বিবেচনা করুন অথবা প্রপার্টি আছে কিনা তা চেক করুন। /maps/documentation/address-validation/understand-response দেখুন।
  • সমস্যা: regionCode বাদ দেওয়া হলে, API ঠিকানা থেকে অঞ্চল অনুমান করে, যা দুর্বল ফলাফল দিতে পারে। সমাধান: আপনি regionCode জানলে, PostalAddress-এ তা অন্তর্ভুক্ত করুন। /maps/documentation/address-validation/requests-validate-address দেখুন।
  • সমস্যা: মার্কিন যুক্তরাষ্ট্রের প্রতিটি যাচাই করা ঠিকানার জন্য uspsData অবজেক্টটি সম্পূর্ণভাবে পূরণ করা হবে কিনা তার কোনও গ্যারেন্টি নেই। সমাধান: একমাত্র যাচাইকরণ সিগন্যাল হিসেবে uspsData-এর উপর নির্ভর করবেন না; রায় ও ঠিকানার কম্পোনেন্টও ব্যবহার করুন। /maps/documentation/address-validation/handle-us-address দেখুন।
  • সমস্যা: provideValidationFeedback-এর সাথে পাঠানো ফিডব্যাকে অবশ্যই সিকোয়েন্সের প্রথম validateAddress কলের responseId-এর রেফারেন্স থাকতে হবে, পরের কোনও কলের নয়। সমাধান: প্রথম validateAddress উত্তর থেকে responseId সেভ করুন এবং ফিডব্যাক অনুরোধে এটি পাঠান। /maps/documentation/address-validation/handle-updated-address দেখুন।

Address Validation API-এর সাহায্যে আপনি কী করতে পারবেন

প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।