ঠিকানা সংক্রান্ত সমস্যা সমাধান করা - উদাহরণ

এই ডকুমেন্টে বাস্তব জগতের এমন অনেক পরিস্থিতি বর্ণনা করা হয়েছে যেখানে Address Validation API এমন রেসপন্স সিগন্যাল প্রদান করে যা আপনার সিস্টেম থেকে সমাধান করার প্রয়োজনীয়তা নির্দেশ করতে পারে। প্রসঙ্গের জন্য আপনার যাচাইকরণ লজিক তৈরি করুন-এ উদাহরণ ওয়ার্কফ্লো দেখুন।

সাধারণ উদাহরণ: ঠিক করা

এই বিভাগে এমন সাধারণ উদাহরণ বর্ণনা করা হয়েছে যেখানে Address Validation API নিম্ন মানের ঠিকানা সংক্রান্ত তথ্য নির্দেশ করে রেসপন্স সিগন্যাল প্রদান করে।

শহর ও পিন কোড নেই

এই উদাহরণে এমন একটি এন্ট্রি দেখানো হয়েছে যেখানে শুধু রাস্তার ঠিকানা আছে, কোনও শহর বা পিন কোড নেই।

শহর ও পিন কোড না থাকার জন্য রায়

নিচের উদাহরণে উত্তরের গুরুত্বপূর্ণ সিগন্যালগুলি হাইলাইট করা হয়েছে।

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true,
  "possibleNextAction": "FIX"
}

possibleNextAction প্রাথমিকভাবে ইঙ্গিত দেয় যে ঠিকানায় ডেলিভারি করা নাও যেতে পারে। অন্যান্য হাইলাইট করা কম্পোনেন্টও এই সম্ভাবনাকে সমর্থন করে, তাই আপনি আরও জানতে addressComponents-এ কোয়েরি করতে পারেন:

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

Address Validation API শুধুমাত্র দেশ (মার্কিন যুক্তরাষ্ট্র) CONFIRMED হিসেবে দেখায়। এটি UNCONFIRMED_BUT_PLAUSIBLE হিসেবে অন্যান্য সব অ্যাড্রেস কম্পোনেন্ট ফিরিয়ে দেয়, যার মধ্যে ডেটার কিছু গুরুত্বপূর্ণ বাদ দেওয়া অংশ থাকে, যেমন এলাকা ও পিন কোড।

রাস্তার নম্বর উল্লেখ করা নেই

এই উদাহরণে রাস্তার নম্বর লেখা হয়নি।

রাস্তার নম্বর না থাকার ব্যাপারে রায়

{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE",
    "possibleNextAction": "FIX"
}

আবারও, possibleNextAction প্রাথমিক ইঙ্গিত দেয় যে ঠিকানায় ডেলিভারি করা নাও যেতে পারে। এছাড়াও, validationGranularity হল ROUTE, যা রাস্তার সাথে মিল নির্দেশ করে, তবে প্রাঙ্গণে পৌঁছানোর জন্য পর্যাপ্ত তথ্য নেই। এছাড়াও, রায়ে addressComplete প্রপার্টি নেই, তাই এটি false। address অবজেক্টের আরও কোয়েরি থেকে জানা গেছে যে কম্পোনেন্টের ধরন উল্লেখ করা নেই:

"missingComponentTypes": [
        "street_number"
      ]

এজ-কেসের উদাহরণ: সমাধান

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

রাস্তার নম্বর কনফার্ম করা হয়নি

এই পরিস্থিতিতে, Address Validation API প্রদত্ত রাস্তার নম্বর কনফার্ম করতে পারে না, তবুও এটি ইঙ্গিত করে যে ঠিকানাটি সম্পূর্ণ।

অনিশ্চিত রাস্তার নম্বরের জন্য রায়

নিচের উদাহরণে গুরুত্বপূর্ণ সিগন্যালগুলি হাইলাইট করা হয়েছে।

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete" : true,
  "hasUnconfirmedComponents": true,
  "possibleNextAction": "ACCEPT"
}

শুধুমাত্র প্রিমাইজ-লেভেল অ্যাপ্রক্সিমেশন সহ যাচাইকরণ গ্র্যানুলারিটির কম্বিনেশন এবং কনফার্ম না করা কম্পোনেন্ট তদন্ত করে দেখা উচিত। addressComponents প্রপার্টির কোয়েরি নিম্নলিখিত কনফার্ম না করা componentType দেখায়:

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

এখানে, street_number-এর confirmation_level UNCONFIRMED_BUT_PLAUSIBLE-এ সেট করা আছে। নিশ্চিত নয়-এর অর্থ হল, পরিষেবাটি তার ডেটাসেটে ৮৪ নম্বর রাস্তার সাথে মিল খুঁজে পাচ্ছে না এবং সম্ভবত-এর অর্থ হল, কম্পোনেন্ট ডেটা এখনও সঠিক হতে পারে।

সাবপ্রিমাইজ নেই

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

উদাহরণস্বরূপ, ধরুন কোনও গ্রাহক সান ফ্রান্সিসকো সিটি অ্যাসেসরের অফিসের জন্য একটি সঠিক ঠিকানা লিখেছেন, কিন্তু ইনপুটে রুম নম্বরটি লিখতে ভুলে গেছেন।

বাদ পড়ে যাওয়া সাব-প্রিমাইসের জন্য রায়

এই উদাহরণে, রায় addressComplete প্রপার্টি দেখায় না, তাই এটি false। এর ফলে, আপনি জানতে পারবেন যে অন্তত একটি ঠিকানার এলিমেন্ট অপ্রত্যাশিত, সমাধান করা হয়নি বা অনুপস্থিত।

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

address কোয়েরি থেকে নিম্নলিখিত তথ্য জানা যায়:

"missingComponentTypes": [
        "subpremise"
      ]

আরও অনুসন্ধানের পরে, USPS ডেটা D-এর একটি dpvConfirmation কোড প্রদান করে, যা একটি অনুপস্থিত সাবপ্রিমিসও নির্দেশ করে।