ঠিকানা যাচাইকরণ সংক্রান্ত সমাধান গাইড

উদ্দেশ্য

Address Validation বিভিন্ন ব্যবহারের ক্ষেত্রে ভ্যালু প্রদান করে এবং টেস্টিং ফলাফলের র কোয়ালিটির বাইরেও গুরুত্বপূর্ণ বিষয় আছে যা আমরা আপনাকে এক্সপ্লোর করার সাজেশন দিই। যেমন: ব্যবহারকারীর ফ্লোতে মানানসই প্রোডাক্টের সামগ্রিক ভিউ, যেমন জায়গা অটোমেটিক সম্পূর্ণ করা এবং Maps, আঞ্চলিক উপলভ্যতা এবং এন্টারপ্রাইজ বিশ্বাস ও নির্ভরযোগ্যতা।

Address Validation API মূল্যায়ন করার পর্যায়ে পৌঁছে গেলে, এখানে কিছু নির্দেশিকা দেওয়া হল যা আপনার টেস্টিংয়ের অংশ হিসেবে ব্যবহার করার জন্য আমরা সাজেস্ট করি।

এই পরীক্ষার লক্ষ্য হল:

1. Address Validation API আপনার ব্যবহারের জন্য উপযুক্ত কিনা তা কনফার্ম করুন।
2. Address Validation API কীভাবে আপনার সমাধানের প্রয়োজনীয়তা পূরণ করে তা যাচাই করুন, যেমন:
   • ভাল কোয়ালিটির ঠিকানা শনাক্ত করা।
   • খারাপ কোয়ালিটির ইনপুট অ্যাড্রেস করার জন্য সতর্ক করা হচ্ছে।
   • অনুমান, প্রতিস্থাপন এবং বানান সংশোধন সহ ঠিকানা ডেটা সংশোধন করা।
   • শিপিংয়ের জন্য ফর্ম্যাট করা ঠিকানা প্রদান করা।
   • সাবপ্রিমাইজ ডেটা (শুধুমাত্র মার্কিন যুক্তরাষ্ট্রে) না থাকা বা ভুল ডেটা সম্পর্কে সতর্ক করা।
3. API প্রয়োগ করার মাধ্যমে আপনি পরিমাপযোগ্য সুবিধা পাবেন কিনা তা নিশ্চিত করুন।

আপনার টেস্ট করার পরে, আপনি উপরের প্রশ্নের উত্তর দিতে পারবেন এবং API আপনার ব্যবসার জন্য উপযুক্ত কিনা তা নির্ধারণ করতে পারবেন।

আপনার ডেটা প্রস্তুত করুন

আপনার আগে থেকে থাকা ঠিকানা ডেটার স্যাম্পেলের সাথে আপনার টেস্টের তুলনা করা উচিত। পরীক্ষার জন্য ডেটা বেছে নেবেন না, তবে আপনি যে ভৌগোলিক অঞ্চলে কাজ করেন তার প্রতিনিধিত্ব করে এমন র‍্যান্ডম স্যাম্পেল বেছে নিন। এর অর্থ হল, আপনি যদি মার্কিন যুক্তরাষ্ট্র এবং যুক্তরাজ্য, উভয় দেশেই ব্যবসা করেন, কিন্তু আপনার ব্যবসার ৭০% যুক্তরাজ্যে এবং ৩০% মার্কিন যুক্তরাষ্ট্রে হয়, তাহলে স্যাম্পেলে সেই বিভাজন প্রতিফলিত হতে হবে।

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

পরীক্ষার জন্য প্রায় ৫,০০০ - ১০,০০০ রেকর্ডের স্যাম্পেল সাইজ প্রস্তুত করুন।

API কল করুন

বিভাগের পূর্বশর্ত: কীভাবে ঠিকানা যাচাইকরণের অনুরোধ পাঠাতে হয় তা বুঝুন।

ডেটা প্রস্তুত করার পরে, আপনাকে API-এর সাথে প্রতিটি ঠিকানা রেকর্ড রান করতে হবে।

API কীভাবে কল করতে হয় সেই বিষয়ে নির্দেশিকা পেতে Address Validation API ডকুমেন্টেশন দেখুন। এছাড়াও, আমাদের কাছে একটি নিবন্ধ আছে যেখানে Address Validation API ব্যবহার করে অনেক বেশি পরিমাণে ঠিকানা প্রসেস করার পেশাদার পদ্ধতি বর্ণনা করা হয়েছে।

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

ফলাফল পর্যালোচনা করুন

বিভাগের পূর্বশর্ত: কীভাবে যাচাইকরণ রেসপন্স ম্যানেজ করতে হয় তা বুঝুন, বিশেষ করে সমাধান, কনফার্ম ও গ্রহণ করার ধারণা।

এই বিভাগে আমরা আউটপুট সিনারিও নিয়ে আলোচনা করব যা আপনি সমাধান ফিট মূল্যায়ন করার জন্য বিশ্লেষণ করতে পারেন।

এই ডকুমেন্টে আলোচনা করা মূল API ফিল্ডের ওভারভিউ

প্রতিক্রিয়া সংক্রান্ত ডেটা	এটি কী?	কীভাবে মূল্যায়ন করবেন	এটি কীভাবে সাহায্য করে?
verdict.inputGranularity	ঠিকানার ইনপুট গ্র্যানুলারিটি বর্ণনা করে।	SUB_PREMISE PREMISE PREMISE_PROXIMITY ব্লক করুন রুট অন্যান্য	ইনপুট করা ঠিকানায় সম্ভাব্যভাবে সঠিক হওয়ার জন্য পর্যাপ্ত ডেটা আছে কিনা তা নির্ধারণ করতে দেয়।
verdict.validationGranularity	ঠিকানার সামগ্রিক আউটপুট যাচাইকরণ বর্ণনা করে।	SUB_PREMISE PREMISE PREMISE_PROXIMITY ব্লক করুন রুট অন্যান্য	API থেকে আউটপুটে সামগ্রিক ঠিকানার কোয়ালিটি নির্ধারণ করতে দেয়।
verdict.hasInferredComponents	API কোনও কম্পোনেন্ট অনুমান করেছে কিনা তা সিগন্যাল করে।	সত্য/মিথ্যা	API ডেটা অনুমান করতে পারলে, উল্লেখ না করা কম্পোনেন্ট যোগ করতে পারে। যেমন, রাজ্যের কোড উল্লেখ করা নেই।
verdict.hasReplacedComponents	API কোনও কম্পোনেন্ট পরিবর্তন করেছে কিনা তা সিগন্যাল করে।	সত্য/মিথ্যা	কিছু ক্ষেত্রে API ভুল কম্পোনেন্টকে সঠিক ডেটা দিয়ে প্রতিস্থাপন করতে পারে।
verdict.addressComplete	ঠিকানা সম্পূর্ণ কিনা তা সিগন্যাল করে।	সত্য/মিথ্যা	API যদি নির্ধারণ করে যে আউটপুট ঠিকানায় সব প্রয়োজনীয় কম্পোনেন্ট আছে, তাহলে এটি সত্য হবে।
address.missingComponentTypes	ঠিকানায় কোনও কম্পোনেন্ট না থাকলে সতর্ক করার জন্য সিগন্যাল।	ভ্যালুর জন্য টেবিল দুই দেখুন।	অসম্পূর্ণ ঠিকানা থেকে বাদ পড়া কম্পোনেন্ট হাইলাইট করুন।

সঠিক ঠিকানা পর্যালোচনা করুন

API থেকে পাওয়া ডেটা সাজিয়ে নিন যাতে আপনার সিস্টেম কোন ঠিকানাগুলি সঠিক হিসেবে গ্রহণ করবে তা নির্ধারণ করতে পারেন। API থেকে যেসব গুরুত্বপূর্ণ সিগন্যাল দেখতে হবে সেগুলি হল:

• verdict.validationGranularity-এ PREMISE বা তার চেয়ে ভাল কোয়ালিটি আছে।
• verdict.addressComplete true।
• কোনও অনুমান করা বা পরিবর্তন করা কম্পোনেন্ট নেই।

আরও তথ্যের জন্য ঠিকানা গ্রহণ করুন বিকল্প দেখুন।

এই এক্সারসাইজের আউটপুট হিসেবে ঠিকানা সংক্রান্ত ডেটার সাবসেট পাওয়া যাবে যা আপনার সিস্টেম বৈধ হিসেবে গ্রহণ করবে। এই পর্যায়ে, আপনি এগুলি নির্ধারণ করতে পারবেন:

• গ্রহণ করার শতকরা হার কি গ্রহণযোগ্য?
• আপনি যদি আগে থেকে থাকা কোনও ঠিকানা যাচাইকরণ ওয়ার্কফ্লো ব্যবহার করেন, তাহলে গ্রহণযোগ্যতার হার কি একই বা আরও ভাল?

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

ঠিকানা লেখা হয়েছে	অঞ্চল
76 Buckingham Palace Road, London SW1W 9TQ	যুক্তরাজ্য

রায়

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

ভুল ঠিকানা পর্যালোচনা করুন

এই ধাপে, ভুল হিসেবে চিহ্নিত করা কিছু অ্যাড্রেস ডেটা ম্যানুয়ালি পর্যালোচনা করার সুযোগ পাওয়া যায় এবং Address Validation API ব্যবহার না করে, সেই ভুল অ্যাড্রেস ডাউনস্ট্রিম সমস্যা তৈরি করতে পারে কিনা তা দেখা যায়।

API থেকে পাওয়া ডেটা সাজিয়ে নিন যাতে আপনার সিস্টেম কোন ঠিকানাগুলিকে ভুল হিসেবে চিহ্নিত করবে তা নির্ধারণ করা যায়। API থেকে যেসব গুরুত্বপূর্ণ সিগন্যাল দেখতে হবে সেগুলি হল:

• আপনার ঝুঁকির লেভেল অনুযায়ী verdict.validationGranularity-এর মান OTHER বা ROUTE সেট করা হয়।
• verdict.addressComplete false।

আরও তথ্যের জন্য ঠিকানা ঠিক করুন বিকল্প দেখুন।

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

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

উদাহরণ: ভুল ঠিকানা

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

রায়

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

অনুপস্থিত বা কনফার্ম না করা কম্পোনেন্ট পর্যালোচনা করুন

এই পর্যায়ে, অনুপস্থিত বা কনফার্ম করা হয়নি এমন কম্পোনেন্টও পর্যালোচনা করা যেতে পারে। এটি রিটার্নে ঠিকানা অবজেক্টের অংশ। দুটি ফিল্ড হল missingComponentTypes এবং unconfirmedComponentTypes।

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

উদাহরণ: অনুপস্থিত ও কনফার্ম না করা কম্পোনেন্ট

ঠিকানা লেখা হয়েছে	অঞ্চল
Fake St, New York, NY 10011	মার্কিন যুক্তরাষ্ট্র

রায়

{
     "inputGranularity": "ROUTE",
     "validationGranularity": "OTHER",
     "geocodeGranularity": "OTHER",
     "hasUnconfirmedComponents": true
}

অনুপস্থিত ও কনফার্ম না করা কম্পোনেন্ট

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

সংশোধন সহ ঠিকানা পর্যালোচনা করুন

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

যেসব মূল সিগন্যাল দেখতে হবে সেগুলি হল:

• inferred, replaced বা spellCorrected, true-এ সেট করা আছে, এগুলির মধ্যে যেকোনও একটিতে addressComponents।
• verdict.hasInferredComponents বা verdict.hasReplacedComponents-এ true সেট করা হয়েছে।

আরও তথ্যের জন্য ঠিকানা কনফার্ম করা দেখুন।

এই অনুশীলনের আউটপুট ঠিকানা ডেটার একটি সাবসেট হওয়া উচিত যা API দ্বারা সংশোধন করা হয়েছে।

এই ডেটার একটি অংশ ম্যানুয়ালি পর্যালোচনা করা যেতে পারে যাতে API আপনার ডেটাতে সংশোধন করছে কিনা তা নির্ধারণ করা যায়, যা আপনার ডাউনস্ট্রিম ওয়ার্কফ্লোতে ঘর্ষণ কমিয়ে দেবে।

উদাহরণ: সংশোধন সহ ঠিকানা

ঠিকানা লেখা হয়েছে	অঞ্চল
76 Bruckingm Palace Road, London SW1W 9TQ	যুক্তরাজ্য

addressComponent নম্বর রুট

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[USA only] Review address with missing or incorrect subpremise data

Address Validation API মার্কিন যুক্তরাষ্ট্রের ঠিকানার ক্ষেত্রে সাবপ্রিমিজ অনুপস্থিত বা ভুল কিনা তা নির্ধারণ করতে পারে।

যেসব গুরুত্বপূর্ণ সিগন্যাল দেখতে হবে সেগুলি হল:

• Address অবজেক্টে:
  • unconfirmedComponentTypes-এর মধ্যে subpremise আছে
  • missingComponentTypes-এর মধ্যে subpremise আছে
• UspsData অবজেক্টে:
  • dpvConfirmation হল D (সাবপ্রিমিজ নেই)
  • dpvConfirmation হল S (সাবপ্রিমাইজ কনফার্ম করা হয়নি)

আরও তথ্যের জন্য মার্কিন যুক্তরাষ্ট্রের ঠিকানা ম্যানেজ করা দেখুন।

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

উদাহরণ: সাবপ্রিমাইজ নেই

ঠিকানা লেখা হয়েছে	অঞ্চল
111 8th Avenue, Manhattan, NY 10011	মার্কিন যুক্তরাষ্ট্র

কম্পোনেন্ট নেই

"missingComponentTypes": [
    "subpremise"
]

USPS ডেটা DPV কনফার্মেশন

"dpvConfirmation": "D"

[USA only] Review USPS standardizedAddress

এছাড়াও, Address Validation API মার্কিন যুক্তরাষ্ট্রের ঠিকানার জন্য USPS স্ট্যান্ডার্ড পদ্ধতিতে লেখা ঠিকানা রিটার্ন করে। আপনার শিপিং লেবেলে USPS ফর্ম্যাট করা ঠিকানা প্রিন্ট করতে হলে এটি বিশেষভাবে গুরুত্বপূর্ণ।

এই ডেটা দেখতে এবং এটি আপনার ওয়ার্কফ্লোতে ভ্যালু যোগ করে কিনা তা নির্ধারণ করতে, UspsAddress পর্যালোচনা করা যেতে পারে।

উদাহরণ: USPS স্ট্যান্ডার্ডাইজড ঠিকানা

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

উপসংহার

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

আরও পড়ার জন্য সাজেস্ট করা বই:

• Address Validation API ডেভেলপার ডকুমেন্টেশন
• Address Validation API ব্যবহার করে অনেক বেশি সংখ্যক ঠিকানা প্রসেস করুন
• ই-কমার্স চেক-আউটের জন্য ঠিকানা যাচাইকরণ

অবদানকারী

হেনরিক ভালভ | DevX ইঞ্জিনিয়ার