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

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

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

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

এই বিভাগে এমন কিছু সাধারণ উদাহরণ বর্ণনা করা হয়েছে যেখানে অ্যাড্রেস ভ্যালিডেশন এপিআই নিম্নমানের ঠিকানা তথ্যের ইঙ্গিত দিয়ে প্রতিক্রিয়া সংকেত প্রদান করে।

শহর এবং পোস্টাল কোড অনুপস্থিত

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

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

অনুপস্থিত শহর এবং পোস্টাল কোডের রায়

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

{
  "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"
}

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

করণীয়: এই ঠিকানার ক্ষেত্রে, ব্যবহারকারীর কাছে অনুপস্থিত তথ্য জানতে চাওয়াটাই বাঞ্ছনীয়।

রাস্তার নম্বর অনুপস্থিত

এই উদাহরণটিতে রাস্তার নম্বরটি অনুপস্থিত।

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

অনুপস্থিত রাস্তার নম্বরের জন্য রায়

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

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

"missingComponentTypes": [
        "street_number"
      ]

করণীয়: এক্ষেত্রে, ব্যবহারকারীর কাছে অনুপস্থিত তথ্যগুলো জানতে চাওয়াটাই বাঞ্ছনীয়।

প্রান্তিক-পরিস্থিতির উদাহরণ: সমাধান

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

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

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

ঠিকানা প্রবেশ করানো হয়েছে	অঞ্চল
৮৪ বাকিংহাম প্যালেস রোড, 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 মানে হলো, পরিষেবাটি তার ডেটাসেটে ৮৪ নম্বর রাস্তাটির সাথে মেলাতে পারছে না, এবং plausible মানে হলো, কম্পোনেন্ট ডেটাটি এখনও বৈধ হতে পারে।

করণীয়: আপনি প্রদত্ত ইনপুটটি গ্রহণ করতে পারেন, অথবা গ্রাহকের সাথে নিশ্চিত হয়ে নিতে পারেন যে রাস্তার নম্বরটি ইচ্ছাকৃত ছিল নাকি ভুলবশত দেওয়া হয়েছে। আপনার প্রতিক্রিয়া আপনার ডেলিভারির সাথে জড়িত ঝুঁকির মাত্রার উপর নির্ভর করে। 'আপনার ভ্যালিডেশন লজিক তৈরি করুন' -এ বাস্তবায়ন নির্দেশিকা দেখুন।

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

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

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

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

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

অনুপস্থিত উপ-ধারণার পক্ষে রায়

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

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

}

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

"missingComponentTypes": [
        "subpremise"
      ]

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

করণীয়: এই ঠিকানার ক্ষেত্রে, ব্যবহারকারীর কাছে অনুপস্থিত তথ্য জানতে চাওয়াটাই বাঞ্ছনীয়।