Address Validation-এর প্রাথমিক রেসপন্স বোঝা

Address Validation API রেসপন্সে এইসব টপ-লেভেল প্রপার্টি থাকে:

{
  // Address details determined by the API.
  "address": {},
  // Validation verdict.
  "verdict": {},
  // The geocode generated for the input address.
  "geocode": {},
  // Information indicating if the address is a business, residence, etc.
  "metadata": {},
  // Information about the address from the US Postal Service
  // ("US" and "PR" addresses only).
  "uspsData": {},
  // A unique identifier generated for every request to the API.
  "responseId": "ID"
}

verdict প্রপার্টি

verdict প্রপার্টি ঠিকানা যাচাইকরণের ফলাফল সংক্ষিপ্ত করে এবং ঠিকানা চেক করার লজিক তৈরি করার সময় মূল্যায়ন করার জন্য প্রথম প্রপার্টি হওয়া উচিত। আউটপুট অ্যাড্রেসের কোয়ালিটির উপর নির্ভর করে, প্রপার্টি বিভিন্ন ধরনের ফিল্ড দেখাতে পারে। যেমন, নিম্নলিখিত উদাহরণে ভালো কোয়ালিটির ঠিকানার verdict প্রপার্টি দেখানো হয়েছে, যা এই নির্দিষ্ট অনুরোধের জন্য নিম্নলিখিত ফিল্ডগুলি রিটার্ন করে:

"verdict": {
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "ACCEPT",
  "addressComplete": true,
  "hasUnconfirmedComponents": false,
  "hasInferredComponents": true,
  "hasReplacedComponents": false
}

নিচের বিভাগগুলি verdict প্রপার্টির সব ফিল্ডের সারসংক্ষেপ দেখায়।

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

ঠিকানার গ্র্যানুলারিটি

ঠিকানার গ্র্যানুলারিটি বলতে কোনও ঠিকানা বা জিওকোডের সুনির্দিষ্টতা নির্ধারণে ব্যবহৃত বিশদ বিবরণের স্তরকে বোঝায়। validationGranularity-এর উত্তরে ঠিকানার নির্দিষ্টতা হল একটি মূল সিগন্যাল যা থেকে বোঝা যায় যে কোনও ঠিকানায় ডেলিভারি করা যাবে কিনা।

verdict প্রপার্টি এই গ্র্যানুলারিটি সিগন্যাল রিটার্ন করে:

  • inputGranularity — Maps JavaScript API-তে Address Validation-এ পাঠানো ঠিকানা থেকে ক্যাপচার করা বিবরণের লেভেল বর্ণনা করে। অনুরোধে ঠিকানার বিবরণের লেভেল যাচাইকরণ উত্তরে ঠিকানার বিবরণের লেভেলকে প্রভাবিত করে। যেমন, PREMISE লেভেলের নিচে inputGranularity সহ কোনও ঠিকানা সাধারণত PREMISE লেভেলে validationGranularity-এর ফলাফল দেয় না।
  • validationGranularity — Maps JavaScript API-তে Address Validation যে গ্র্যানুলারিটি লেভেল পর্যন্ত ঠিকানা সম্পূর্ণভাবে যাচাই করতে পারে। বেশিরভাগ ক্ষেত্রে, PREMISE বা SUB_PREMISE গ্র্যানুলারিটি লেভেল একটি কোয়ালিটি অ্যাড্রেসকে নির্দেশ করে যা ডেলিভারি করার উপযুক্ত।
  • geocodeGranularity — ঠিকানার সাথে সম্পর্কিত জিওকোডের বিবরণের লেভেল বর্ণনা করে। যেমন, Google রেকর্ডে কোনও অ্যাপার্টমেন্ট নম্বর থাকতে পারে, কিন্তু একটি বড় অ্যাপার্টমেন্ট কমপ্লেক্সের মধ্যে সেই নির্দিষ্ট অ্যাপার্টমেন্টের সুনির্দিষ্ট লোকেশন নাও থাকতে পারে। সেক্ষেত্রে, validationGranularity হল SUB_PREMISE কিন্তু geocodeGranularity হল PREMISE।
রেফারেন্স গাইডে গ্র্যানুলারিটি দেখুন।

ঠিকানা সম্পূর্ণ কিনা

রায়টি addressComplete প্রপার্টিকে খুব ভাল কোয়ালিটির ঠিকানার সিগন্যাল হিসেবে ফেরত দেয়, যার অর্থ হল, এতে কোনও অনুপস্থিত, অমীমাংসিত বা অপ্রত্যাশিত কম্পোনেন্ট নেই:

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "PREMISE",
    "geocodeGranularity": "PREMISE",
    "addressComplete": true
}

ঠিকানায় কোনও কম্পোনেন্ট না থাকলে, সমাধান না করা থাকলে বা অপ্রত্যাশিত কম্পোনেন্ট থাকলে, ফিল্ডটি false-এ সেট করা হয়।

রেফারেন্স গাইডে রায় এবং ঠিকানা-এর অধীনে addressComplete দেখুন।

ঠিকানার কোয়ালিটি

সম্ভাব্য ফিল্ডের সংখ্যা হয় ঠিকানা সংক্রান্ত উপাদানের সমস্যা অথবা সেগুলির অ্যাডজাস্টমেন্ট নির্দেশ করে, যেমন অনুমান করা বা অনুপস্থিত ঠিকানা সংক্রান্ত উপাদান। যেমন, নিম্নলিখিত verdict প্রপার্টি এমন একটি ঠিকানা নির্দেশ করে যার কম্পোনেন্ট কনফার্ম করা হয়নি এবং addressComplete ফিল্ডটি নেই:

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "OTHER",
    "geocodeGranularity": "OTHER",
    "hasUnconfirmedComponents": true,
    "hasInferredComponents": true
}
রেফারেন্স গাইডে রায় দেখুন।

সম্ভাব্য পরবর্তী অ্যাকশন

possibleNextAction রায় ফিল্ড API রেসপন্সের একটি ব্যাখ্যামূলক সারসংক্ষেপ প্রদান করে, যার উদ্দেশ্য হল পরবর্তী সম্ভাব্য অ্যাকশন নির্ধারণে সহায়তা করা। এই ফিল্ডটি API রেসপন্সের অন্যান্য ফিল্ড থেকে নেওয়া হয়েছে এবং এটি ঠিকানার নির্ভুলতা বা ডেলিভারিযোগ্যতার গ্যারান্টি হিসেবে বিবেচনা করা উচিত নয়।

address এবং addressComponent প্রপার্টি

address প্রপার্টি অনুরোধে দেওয়া প্রসেস করা ঠিকানার ফর্ম্যাটিং প্রদান করে, এর সাথে ঠিকানার কম্পোনেন্ট-লেভেল সারসংক্ষেপও প্রদান করে, যার মধ্যে ঠিকানার ভুল বানান, ভুল অংশ পরিবর্তন করা এবং অনুমান করা বাদ যাওয়া অংশ অন্তর্ভুক্ত।

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

addressComponent প্রপার্টি হল address-এর একটি সাবকম্পোনেন্ট যা Maps JavaScript API-তে Address Validation প্রসেস করেছে এমন ঠিকানার এলিমেন্ট—বা কম্পোনেন্টের—একটি বিস্তারিত তালিকা প্রদান করে। API প্রতিটি কম্পোনেন্ট ফিল্ডকে তার নাম, ধরন এবং কনফার্মেশন লেভেল দ্বারা শনাক্ত করে।

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

geocode প্রপার্টি

geocode প্রপার্টি ইনপুট করা ঠিকানার সাথে যুক্ত জিওকোড করা লোকেশন নির্দেশ করে। এই প্রপার্টি লোকেশন সম্পর্কে বিবরণ প্রদান করে, যেমন এর প্লেস আইডি।

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

metadata প্রপার্টি

Maps JavaScript API-তে Address Validation-এর মাধ্যমে প্রসেস করা প্রতিটি ঠিকানার জন্য এই প্রপার্টি হয়ত পপুলেট করা হবে না, তবে ঠিকানাটি আবাসিক, ব্যবসা বা PO Box কিনা তা নির্দেশ করে।

Address Validation API কভারেজ এবং Address metadata-এর জন্য রেফারেন্স দেখুন।

uspsData প্রপার্টি

এই প্রপার্টি মার্কিন যুক্তরাষ্ট্রের ডাক ঠিকানার জন্য প্রয়োজনীয় তথ্য প্রদান করে। তবে, পরিষেবার মাধ্যমে যাচাই করা প্রতিটি ঠিকানার জন্য এটি সম্পূর্ণভাবে পূরণ করা হবে কিনা তার কোনও গ্যারেন্টি নেই। সেই কারণে, ঠিকানা যাচাই করার একমাত্র উপায় হিসেবে এই প্রপার্টির উপর নির্ভর করবেন না, বরং verdict এবং address-ও চেক করুন।

মার্কিন যুক্তরাষ্ট্রের ঠিকানা ম্যানেজ করা এবং USPSData-এর জন্য রেফারেন্স দেখুন।