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

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

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

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

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

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

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

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

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

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

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

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

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

ঠিকানা দেওয়া হয়েছে অঞ্চল
বাকিংহাম প্যালেস রোড, SW1W 9TQ লন্ডন যুক্তরাজ্য
অনুপস্থিত রাস্তার নম্বরের জন্য রায় 
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE",
    "possibleNextAction": "FIX"
}

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

"missingComponentTypes": [
        "street_number"
      ]

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

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

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

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

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

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

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

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

অনুপস্থিত subpremise

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

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

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

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

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

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

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

"missingComponentTypes": [
        "subpremise"
      ]

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