ঠিকানা ঠিক করুন - উদাহরণ

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

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

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

এই বিভাগটি এমন সাধারণ উদাহরণ বর্ণনা করে যেখানে ঠিকানা যাচাইকরণ 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"
}

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

পদক্ষেপ: এই ঠিকানার জন্য, ব্যবহারকারীকে অনুপস্থিত তথ্যের জন্য অনুরোধ করা প্রস্তাবিত পদক্ষেপ।

রাস্তার নম্বর নেই

এই উদাহরণে একটি অনুপস্থিত রাস্তার নম্বর দেখানো হয়েছে।

ঠিকানা লেখা হয়েছে	অঞ্চল
বাকিংহাম প্যালেস রোড, SW1W 9TQ লন্ডন	যুক্তরাজ্য

রাস্তার নম্বর বাদ দেওয়ার রায়

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

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

"missingComponentTypes": [
        "street_number"
      ]

পদক্ষেপ: এই ক্ষেত্রে, সুপারিশকৃত পদক্ষেপ হল ব্যবহারকারীকে অনুপস্থিত তথ্যের জন্য অনুরোধ করা।

এজ-কেস উদাহরণ: ঠিক করুন

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

অনিশ্চিত রাস্তার নম্বর

এই পরিস্থিতিতে, ঠিকানা যাচাইকরণ API সরবরাহকৃত রাস্তার নম্বর নিশ্চিত করতে পারে না, তবুও এটি নির্দেশ করে যে ঠিকানাটি সম্পূর্ণ।

ঠিকানা লেখা হয়েছে	অঞ্চল
৮৪ বাকিংহাম প্যালেস রোড, SW1W 9TQ, লন্ডন	যুক্তরাজ্য

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

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

{
  "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 এ সেট করা আছে। Unconfirmed এর অর্থ হল পরিষেবাটি তার ডেটাসেটে 84 নম্বরের street নম্বরের সাথে মিলছে না, এবং সম্ভাব্য এর অর্থ হল কম্পোনেন্ট ডেটা এখনও বৈধ হতে পারে।

পদক্ষেপ: আপনি হয় প্রবেশ করানো ইনপুটটি যেমনটি ছিল তেমনই গ্রহণ করতে পারেন, অথবা গ্রাহকের সাথে নিশ্চিত করতে পারেন যে প্রবেশ করানো রাস্তার নম্বরটি উদ্দেশ্যপ্রণোদিত ছিল নাকি ত্রুটি ছিল। আপনার প্রতিক্রিয়া আপনার ডেলিভারির সাথে সম্পর্কিত ঝুঁকির স্তরের উপর নির্ভর করে। Build your validation logic -এ বাস্তবায়ন নির্দেশিকা দেখুন।

উপ-প্রধান অংশ অনুপস্থিত

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

দ্রষ্টব্য: কিছু দেশে, ঠিকানা যাচাইকরণ API একটি অনুপস্থিত সাবপ্রিমিস সনাক্ত করতে পারে না; অন্যদিকে মার্কিন যুক্তরাষ্ট্রে, একটি অনুপস্থিত SUB_PREMISE একটি অ-ডেলিভারিযোগ্য ঠিকানা নির্দেশ করে।

উদাহরণস্বরূপ, ধরুন একজন গ্রাহক সান ফ্রান্সিসকো শহরের মূল্যায়নকারীর অফিসের জন্য একটি বৈধ ঠিকানা প্রবেশ করান, কিন্তু ইনপুট থেকে রুম নম্বরটি বাদ দেন।

ঠিকানা লেখা হয়েছে	অঞ্চল
১ ডাক্তার কার্লটন বি গুডলেট প্লেস, সান ফ্রান্সিসকো, সিএ ৯৪১০২	আমেরিকা

উপ-প্রাইমাইজ অনুপস্থিতির রায়

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

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

}

একটি address অনুসন্ধান নিম্নলিখিত বিষয়গুলি প্রকাশ করে:

"missingComponentTypes": [
        "subpremise"
      ]

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

পদক্ষেপ: এই ঠিকানার জন্য, ব্যবহারকারীকে অনুপস্থিত তথ্যের জন্য অনুরোধ করা প্রস্তাবিত পদক্ষেপ।