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

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

দ্রষ্টব্য: এখানে উদাহরণগুলি দৃষ্টান্তমূলক, কিন্তু সম্পূর্ণ নয়।

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

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

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

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

ঠিকানা দেওয়া হয়েছে	অঞ্চল
21 45 40 তম রাস্তা	আমেরিকা

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

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

{
  "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 বস্তুর আরও একটি ক্যোয়ারী একটি অনুপস্থিত উপাদান প্রকার প্রকাশ করে:

"missingComponentTypes": [
        "street_number"
      ]

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

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

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

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

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

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

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

অনুপস্থিত subpremise

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

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

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

ঠিকানা দেওয়া হয়েছে	অঞ্চল
1 ডাক্তার কার্লটন বি গুডলেট প্লেস, সান ফ্রান্সিসকো, CA 94102	আমেরিকা

অনুপস্থিত subpremise জন্য রায়

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

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

}

একটি address প্রশ্ন নিম্নলিখিত প্রকাশ করে:

"missingComponentTypes": [
        "subpremise"
      ]

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

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