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

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

পরামর্শ: ঠিকানা যাচাইকরণ ডেমো খুলুন এবং নিজের জন্য উদাহরণ হিসেবে দেওয়া ঠিকানা যাচাই করার চেষ্টা করুন।

সাধারণ উদাহরণ: সমাধান

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

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

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

ঠিকানা লেখা হয়েছে	অঞ্চল
২১ ৪৫ ৪০তম স্ট্রিট	মার্কিন যুক্তরাষ্ট্র

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

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

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

এইসব সিগন্যাল থেকে বোঝা যায় যে ঠিকানাটি ডেলিভারি করার উপযুক্ত নয়, তাই আপনি আরও জানতে 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 হিসেবে অন্যান্য সব অ্যাড্রেস কম্পোনেন্ট ফিরিয়ে দেয়, যার মধ্যে ডেটার কিছু গুরুত্বপূর্ণ বাদ দেওয়া অংশ থাকে, যেমন এলাকা ও পিন কোড।

অ্যাকশন: এই ঠিকানার জন্য, প্রস্তাবিত অ্যাকশন হল ব্যবহারকারীকে অনুপস্থিত তথ্যের জন্য প্রম্পট করা।

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

এই উদাহরণে রাস্তার নম্বর নেই।

ঠিকানা লেখা হয়েছে	অঞ্চল
Buckingham Palace Road, SW1W 9TQ London	যুক্তরাজ্য

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

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

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

"missingComponentTypes": [
        "street_number"
      ]

অ্যাকশন: এই ক্ষেত্রে, ব্যবহারকারীকে অনুপস্থিত তথ্য দেওয়ার জন্য প্রম্পট করার সাজেশন দেওয়া হয়।

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

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

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

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

ঠিকানা লেখা হয়েছে	অঞ্চল
84 Buckingham Palace Road, SW1W 9TQ, London	যুক্তরাজ্য

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

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

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

শুধুমাত্র প্রাঙ্গণ-লেভেল আনুমানিকতার সাথে যাচাইকরণ গ্র্যানুলারিটির সংমিশ্রণ তদন্ত করা মূল্যবান অনিশ্চিত উপাদানের সাথে। 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 এবং তাই রায়ের ম্যানুয়াল পরিদর্শনে উপস্থিত নেই।

মনে রাখবেন: কিছু দেশে, Address Validation API কোনও অনুপস্থিত সাবপ্রিমাইজ শনাক্ত করতে পারে না; মার্কিন যুক্তরাষ্ট্রে, অনুপস্থিত SUB_PREMISE একটি ডেলিভারি করা যাবে না এমন ঠিকানা নির্দেশ করে।

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

ঠিকানা লেখা হয়েছে	অঞ্চল
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102	মার্কিন যুক্তরাষ্ট্র

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

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

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true

}

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

"missingComponentTypes": [
        "subpremise"
      ]

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

অ্যাকশন: এই ঠিকানার জন্য, প্রস্তাবিত অ্যাকশন হল ব্যবহারকারীকে অনুপস্থিত তথ্যের জন্য প্রম্পট করা।