একটি মৌলিক ঠিকানা বৈধতা প্রতিক্রিয়া বুঝতে

ঠিকানা যাচাইকরণ API একটি JSON অবজেক্ট হিসাবে একটি প্রতিক্রিয়া বডি প্রদান করে যাতে দুটি শীর্ষ-স্তরের বৈশিষ্ট্য রয়েছে:

  • result , ValidationResult টাইপের একটি বস্তু
  • responseID
{
  "result": {
    // Validation verdict.
    "verdict": {},
    // Address details determined by the API.
    "address": {},
    // 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"
}

এই নথিটি result বস্তুর উপর ফোকাস করে। responseID সম্পর্কে তথ্যের জন্য, আপডেট করা ঠিকানাগুলি হ্যান্ডেল দেখুন।

verdict সম্পত্তি

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

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

নিম্নলিখিত বিভাগগুলি verdict সম্পত্তির সমস্ত ক্ষেত্রকে সংক্ষিপ্ত করে।

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

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

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

verdict সম্পত্তি এই গ্রানুলারিটি সংকেত প্রদান করে:

  • inputGranularity — ঠিকানা যাচাইকরণ API এ পাঠানো ঠিকানা থেকে ক্যাপচার করা বিশদ স্তর বর্ণনা করে। অনুরোধে ঠিকানার বিশদ স্তরটি বৈধকরণ প্রতিক্রিয়াতে ঠিকানার বিশদ স্তরকে প্রভাবিত করে। উদাহরণস্বরূপ, PREMISE নীচের স্তরের নীচে একটি inputGranularity সহ একটি ঠিকানা সাধারণত একটি PREMISE স্তরে একটি validationGranularity ফলাফল দেয় না।
  • validationGranularity — কণিকা স্তর যা ঠিকানা যাচাইকরণ API ঠিকানাটিকে সম্পূর্ণরূপে যাচাই করতে পারে। বেশিরভাগ ক্ষেত্রে, PREMISE বা SUB_PREMISE এর একটি গ্রানুলারিটি স্তর একটি গুণমানের ঠিকানা নির্দেশ করে যা সম্ভবত বিতরণযোগ্য।
  • geocodeGranularity — ঠিকানার সাথে যুক্ত জিওকোডের বিস্তারিত স্তর বর্ণনা করে। উদাহরণস্বরূপ, Google রেকর্ডগুলি একটি অ্যাপার্টমেন্ট নম্বরের অস্তিত্ব নির্দেশ করতে পারে, কিন্তু একটি বড় অ্যাপার্টমেন্ট কমপ্লেক্সের মধ্যে সেই নির্দিষ্ট অ্যাপার্টমেন্টের জন্য একটি সুনির্দিষ্ট অবস্থান নয়৷ সেই ক্ষেত্রে, validationGranularity হল SUB_PREMISE কিন্তু geocodeGranularity is 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
}
রেফারেন্স গাইডে রায় দেখুন।

address এবং addressComponent বৈশিষ্ট্য

address সম্পত্তি অনুরোধে প্রদত্ত প্রক্রিয়াকৃত ঠিকানার জন্য বিন্যাস প্রদান করে, ঠিকানার উপাদান-স্তরের সারাংশ সহ, ঠিকানার ভুল বানান অংশ, প্রতিস্থাপিত ভুল অংশ এবং অনুমান করা অনুপস্থিত অংশগুলি সহ।

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

addressComponent প্রপার্টি হল address একটি সাবকম্পোনেন্ট যা অ্যাড্রেস ভ্যালিডেশন এপিআই প্রসেস করা অ্যাড্রেসের উপাদান বা উপাদানগুলির বিস্তারিত তালিকা প্রদান করে। API প্রতিটি উপাদান ক্ষেত্রকে তার নাম, ধরন এবং নিশ্চিতকরণ স্তর দ্বারা চিহ্নিত করে।

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

geocode সম্পত্তি

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

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

metadata সম্পত্তি

ঠিকানা যাচাইকরণ API দ্বারা প্রক্রিয়া করা প্রতিটি ঠিকানার জন্য এই সম্পত্তিটি জনবহুল নাও হতে পারে, তবে ঠিকানাটি আবাসিক, ব্যবসা বা একটি PO বক্সের প্রকারের কিনা তা নির্দেশ করে।

ঠিকানা যাচাইকরণ API কভারেজ এবং Address metadata রেফারেন্স দেখুন।

uspsData বৈশিষ্ট্য

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

হ্যান্ডেল ইউনাইটেড স্টেটস ঠিকানা এবং UspsData এর রেফারেন্স দেখুন।
পূর্ববর্তী
একটি ঠিকানা যাচাইকরণ অনুরোধ পাঠান
পরবর্তী
আপনার বৈধতা যুক্তি তৈরি করুন