ঠিকানা নিশ্চিত করুন - উদাহরণ

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

সাধারণ উদাহরণ: নিশ্চিত করুন

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

প্রতিস্থাপিত তথ্যের রায়

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

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
  "hasReplacedComponents": true,
  "possibleNextAction": "CONFIRM"
}

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

ঠিকানার উপাদানগুলির একটি প্রশ্ন নিম্নলিখিত উদ্বেগের ক্ষেত্রগুলি প্রকাশ করে:

{
  "componentName": {
    "text": "451",
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
...
{
  "componentName": {
    "text": "98104",
  },
  "componentType": "postal_code",
  "confirmationLevel": "CONFIRMED",
  "replaced": true
}
...
{
  "componentName": {
    "text": "Building D",
    "language_code": "en"
  },
  "componentType": "subpremise",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
.......

    "unconfirmedComponentTypes": [
      "street_number",
      "subpremise"
    ]

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

এজ-কেস উদাহরণ: নিশ্চিত করুন

নিম্নলিখিত উদাহরণগুলি নিম্নলিখিত এজ কেস প্রকারগুলিকে চিত্রিত করে:

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

নিশ্চিত হওয়া ছোটখাটো অনুমান

আরও সূক্ষ্ম স্তরের নিশ্চিত ডেটার সাথে একত্রিত করা হলে, যদি ইনপুটটিতে নিম্নলিখিত ধরণের কেবলমাত্র একটি উপাদান অনুপস্থিত থাকে তবে API এখনও একটি সঠিক অনুমান করতে পারে:

• শহর
• রাজ্য
• পোস্টাল কোড
• দেশ

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

অনুপস্থিত শহরের রায়

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

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

উপরের উদাহরণটি ব্যবহার করে, সমস্ত ঠিকানা উপাদান জুড়ে একটি স্ক্যান দেখায় যে প্রতিটি উপাদান নিশ্চিত করা হয়েছে, যার অর্থ এটি ঠিকানা বৈধকরণ API দ্বারা সংরক্ষিত ডেটার সাথে মেলে এবং পরিষেবাটি দুটি উচ্চ-স্তরের উপাদানও অনুমান করে।

{
  "componentName": {
    "text": "Springfield",
    "languageCode": "en"
  },
  "componentType": "locality",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
},
{
  "componentName": {
    "text": "1806"
  },
  "componentType": "postal_code_suffix",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
}

অপ্রত্যাশিত ঠিকানা উপাদান নিশ্চিত করা হয়নি

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

উদাহরণস্বরূপ, একটি ঠিকানা এমন একটি অঞ্চলের হতে পারে যেখানে গ্রাহকরা প্রায়শই ডাক কর্তৃপক্ষের দ্বারা উপেক্ষা করা ক্ষতিকারক তথ্য প্রবেশ করান, সেই ক্ষেত্রে আপনি ঠিকানাটি গ্রহণ করবেন। তবে, কিছু ক্ষেত্রে একটি অ-নিশ্চিত উপাদান গ্রাহক যা চান তা নাও হতে পারে।

অপ্রত্যাশিত ঠিকানা উপাদানের রায় নিশ্চিত হয়নি

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "unconfirmedComponents": true,
  "possibleNextAction": "ACCEPT"
}

অনিশ্চিত উপাদান সহ একটি রায় ছাড়াও, ঠিকানা যাচাইকরণ API নিম্নলিখিত ফর্ম্যাট করা ঠিকানাটি ফেরত দেয়:

"formattedAddress": "59 Cherrydown Avenue, London E4 8DT, UK",

নিশ্চিত না হওয়া উপাদানগুলির জন্য স্ক্যান করলে দেখা যায় যে API ফিরে আসা ঠিকানা থেকে চিংফোর্ডকে সরিয়ে দিয়েছে:

{
  "componentName": {
    "text": "Chingford",
    "languageCode": "en"
  },
  "componentType": "sublocality_level_1",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
  "unexpected": true
}

অপ্রত্যাশিত ঠিকানা উপাদান যা IS দ্বারা নিশ্চিত করা হয়েছে

এই উদাহরণটি সরবরাহিত ঠিকানায় একটি যুক্তরাজ্যের কাউন্টি অন্তর্ভুক্ত করার চিত্র তুলে ধরে, যা একটি সাধারণ অনুশীলন। তবে, এটি যুক্তরাজ্যের ডাক কর্তৃপক্ষের দ্বারা বাধ্যতামূলক নয় এবং মূলত উপেক্ষা করা হয়। postoffice.co.uk এবং How to address UK and international mail দেখুন।

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

আইএস কর্তৃক নিশ্চিত করা অপ্রত্যাশিত ঠিকানা উপাদানের রায়

{
   "inputGranularity": "PREMISE",
   "validationGranularity": "PREMISE",
   "geocodeGranularity": "PREMISE",
   "possibleNextAction": "ACCEPT"
}

এখানে, address_complete মিথ্যা হিসাবে মূল্যায়ন করে এবং ঠিকানা উপাদানের বিশ্লেষণ একটি অপ্রত্যাশিত পতাকা প্রকাশ করে।

{
  "componentName": {
    "text": "Gloucestershire",
    "languageCode": "en"
  },
  "componentType": "administrative_area_level_2",
  "confirmationLevel": "CONFIRMED",
  "unexpected": true
}

যদিও গ্লৌচেস্টারশায়ার প্রবেশ করানো ঠিকানার জন্য সঠিক কাউন্টি, ঠিকানাটি নিজেই ভুলভাবে ফর্ম্যাট করা হয়েছে। মনে রাখবেন যে ঠিকানা যাচাইকরণ API সঠিক ফর্ম্যাটিংয়ের জন্য তথ্য মূল্যায়ন করে।