ঠিকানা কনফার্ম করা - উদাহরণ

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

সাধারণ উদাহরণ: কনফার্ম করুন

একই ধরনের রাস্তার নাম সহ মেট্রোপলিটন এলাকার ক্ষেত্রে নিম্নলিখিত উদাহরণটি ব্যাখ্যা করে। ধরুন, কোনও ব্যবহারকারী Google Building D in Kirkland, WA, United States-এর ঠিকানা লিখতে চান। তবে, শহরের নাম হিসেবে Kirkland-এর পরিবর্তে তারা ভুলবশত Seattle লিখে ফেলেন।

ঠিকানা লেখা হয়েছে অঞ্চল
Building D, 451 7th Avenue South, Seattle, WA 98033 মার্কিন যুক্তরাষ্ট্র

পরিবর্তিত ডেটার জন্য রায়

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

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

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"
    ]

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

এজ-কেসের উদাহরণ: কনফার্ম করুন

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

ছোটখাটো অনুমান যা কনফার্ম করা হয়েছে

আরও গ্র্যানুলার লেভেলের কনফার্ম করা ডেটার সাথে একত্রিত করা হলে, ইনপুটে নিম্নলিখিত ধরনের শুধুমাত্র একটি কম্পোনেন্ট না থাকলেও, API এখনও সঠিক অনুমান করতে পারে:

  • শহর
  • রাজ্য
  • পিনকোড
  • দেশ

যেমন, কোনও গ্রাহক ম্যাসাচুসেটসের স্প্রিংফিল্ডে McDonald's রেস্তোরাঁর জন্য সঠিক রাস্তার ঠিকানা দিয়েছেন, কিন্তু শহরের নাম লিখতে ভুলে গেছেন এবং ৪-সংখ্যার এক্সটেনশন ছাড়াই পিন কোড দিয়েছেন।

ঠিকানা লেখা হয়েছে অঞ্চল
1402 Allen St, MA 01118 মার্কিন যুক্তরাষ্ট্র

শহরের নাম না থাকার জন্য রায়

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

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

উপরে দেওয়া উদাহরণ অনুযায়ী, সব অ্যাড্রেস কম্পোনেন্ট স্ক্যান করে দেখা গেছে যে প্রতিটি কম্পোনেন্ট কনফার্ম করা হয়েছে, অর্থাৎ Address Validation API-তে স্টোর করা ডেটার সাথে এটি মিলে গেছে এবং পরিষেবাটি আরও দুটি উচ্চ-লেভেলের কম্পোনেন্ট অনুমান করেছে।

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

অপ্রত্যাশিত ঠিকানা কম্পোনেন্ট কনফার্ম করা হয়নি

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

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

ঠিকানা লেখা হয়েছে অঞ্চল
1 Rue Grenache, la caritat 2, 34630 Saint-Thibéry ফ্রান্স

অপ্রত্যাশিত ঠিকানা কম্পোনেন্টের জন্য রায় কনফার্ম করা হয়নি

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

অনিশ্চিত কম্পোনেন্ট সহ রায় ছাড়াও, Address Validation API নিম্নলিখিত ফর্ম্যাট করা ঠিকানা রিটার্ন করে:

"formattedAddress": "1 Rue Grenache, 34630 Saint-Thibéry, France",

অযাচাইকৃত কম্পোনেন্টের জন্য করা স্ক্যান থেকে দেখা যায় যে API, ফেরত পাঠানো ঠিকানা থেকে la caritat 2 সরিয়ে দিয়েছে:

{
  "componentName": {
    "text": "la caritat 2",
    "languageCode": "fr"
  },
  "componentType": "sublocality_level_1",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
  "unexpected": true
}

ঠিকানার অপ্রত্যাশিত অংশ যা কনফার্ম করা হয়েছে

এই উদাহরণে দেখানো হয়েছে যে প্রদত্ত ঠিকানায় যুক্তরাজ্যের কাউন্টির নাম অন্তর্ভুক্ত করা হয়েছে, যা সাধারণত করা হয়ে থাকে। তবে, এটি যুক্তরাজ্যের ডাক কর্তৃপক্ষের প্রয়োজনীয়তা নয় এবং এটি মূলত উপেক্ষা করা হয়। postoffice.co.uk এবং যুক্তরাজ্য ও আন্তর্জাতিক মেল কীভাবে পাঠাতে হয় তা দেখুন।

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

ঠিকানা লেখা হয়েছে অঞ্চল
33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP যুক্তরাজ্য

অপ্রত্যাশিত ঠিকানা কম্পোনেন্টের জন্য রায় যা কনফার্ম করা হয়েছে

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

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

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

যদিও Gloucestershire হল লেখা ঠিকানার জন্য সঠিক কাউন্টি, ঠিকানাটি সঠিকভাবে ফর্ম্যাট করা হয়নি। মনে রাখবেন যে Address Validation API সঠিক ফর্ম্যাটিংয়ের জন্য তথ্য মূল্যায়ন করে।