এই ডকুমেন্টটি Address Validation API থেকে বিভিন্ন ধরনের উত্তর ম্যানেজ করার জন্য একটি ঠিকানা চেক করার সিস্টেম তৈরি করার প্রক্রিয়া বর্ণনা করে। এটি কভার করে যে কীভাবে আপনার লজিক তৈরি করতে হয় যাতে উত্তরটি সঠিকভাবে ব্যবহার করা যায়, API থেকে অন্যান্য সিগন্যাল তদন্ত করা যায় এবং কখন এবং কীভাবে আপনার গ্রাহকদের আরও তথ্যের জন্য প্রম্পট করতে হয়।
সাধারণত, API রেসপন্স নির্ধারণ করে যে আপনার সিস্টেমকে নিম্নলিখিত উপায়ে কোনও ঠিকানা ম্যানেজ করতে হবে:
- ঠিক করুন—ঠিকানাটি খারাপ কোয়ালিটির। আরও তথ্যের জন্য আপনাকে প্রম্পট করতে হবে।
- কনফার্ম করুন—ঠিকানাটি খুব ভাল কোয়ালিটির, তবে ইনপুট করা ঠিকানা থেকে পরিবর্তন করা হয়েছে। আপনাকে কনফার্মেশনের জন্য প্রম্পট করা হতে পারে।
- গ্রহণ করুন—অ্যাড্রেসটি খুব ভালো কোয়ালিটির। আপনি প্রদত্ত ঠিকানা গ্রহণ করতে পারেন।
মূল উদ্দেশ্য
এই ডকুমেন্ট আপনাকে API রেসপন্স বিশ্লেষণ করতে এবং প্রদত্ত ঠিকানার সাথে পরবর্তী পদক্ষেপ নির্ধারণ করতে আপনার সিস্টেমকে পরিবর্তন করতে সাহায্য করে। নিম্নলিখিত সিউডোকোড সম্ভাব্য ফ্লো ব্যাখ্যা করে।
if (the API response indicates significant problems in the address)
FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
CONFIRM - confirm with the user that the address is correct
else
ACCEPT - continue with the address returned by the API.
আপনার পরিস্থিতির উপর নির্ভর করে সঠিক লজিক প্রয়োগ করা হয়; আরও জানতে প্রয়োগ সংক্রান্ত নির্দেশিকা দেখুন। এছাড়াও, আপনি এই লজিকের ওপেন সোর্স ইমপ্লিমেন্টেশন ব্যবহার করতে পারেন, যা এক্সটেন্ডেড কম্পোনেন্ট লাইব্রেরি-তে রয়েছে।
ওয়ার্কফ্লো ওভারভিউ
নিচের সারণীতে আপনার সিস্টেমের জন্য দুটি অ্যাকশনের সারসংক্ষেপ দেওয়া হয়েছে:
- সমাধান, কনফার্ম, সম্মতি সংক্রান্ত আচরণের উপর ভিত্তি করে ব্যবহার করার জন্য ওয়ার্কফ্লো।
- উত্তরে প্রথম যে সিগন্যাল চেক করতে হবে। এখানে বর্ণিত সিগন্যালগুলি
verdictপ্রপার্টি থেকে আসে এবং এগুলিই চেক করার জন্য একমাত্র সিগন্যাল নয়, তবে ঠিকানার কোয়ালিটি সম্পর্কে প্রাথমিক ইঙ্গিত দেয়। প্রতিটি আচরণের ধরন এই ডকুমেন্টের একটি বিভাগের সাথে সম্পর্কিত যা আরও সিগন্যাল বর্ণনা করে যা আপনাকে তদন্ত করতে হতে পারে।
| আপনার সিস্টেমের আচরণ | |||
|---|---|---|---|
| ঠিকানা ঠিক করুন |
|
||
| ঠিকানা কনফার্ম করুন |
|
||
| ঠিকানা গ্রহণ করুন |
Address Validation API-এর উত্তর থেকে বোঝা যায় যে ঠিকানাটি খুব ভাল কোয়ালিটির।
|
||
প্রয়োগ সংক্রান্ত নির্দেশিকা
ঠিকানা যাচাইকরণ সিগন্যালে আপনার সিস্টেম কীভাবে প্রতিক্রিয়া জানাবে তা ডিজাইন করার সময়, নিম্নলিখিত সাজেশনগুলি আপনাকে আরও কার্যকর প্রতিক্রিয়া মডেল তৈরি করতে সাহায্য করতে পারে। তবে, এগুলি শুধুমাত্র সাজেশন, তাই মনে রাখবেন যে আপনার প্রয়োগ আপনার বিজনেস মডেলের সাথে মানানসই হতে হবে।
| নির্দেশিকা | বিবরণ | |
|---|---|---|
| ঝুঁকির লেভেল |
ঠিক করার জন্য প্রম্পট করা এবং ঠিকানা যেমন লেখা হয়েছে তেমন গ্রহণ করার মধ্যে ভারসাম্য বজায় রাখার সময় আপনার পরিস্থিতির জন্য সহনশীলতার লেভেল বিবেচনা করুন। |
Address Validation API বিভিন্ন ধরনের সিগন্যাল প্রদান করে যা আপনি নিজের যাচাইকরণ প্রসেস অপ্টিমাইজ করার জন্য ঝুঁকির লেভেলের সাথে যোগ করতে পারেন। যেমন, কোনও ঠিকানায় যদি রাস্তার নম্বর কনফার্ম করা না থাকে, তাহলেও আপনি এটি গ্রহণ করতে পারবেন। অন্যদিকে, আপনার ব্যবসার অপারেশনের জন্য যদি আরও নিখুঁত ঠিকানা প্রয়োজন হয়, তাহলে আপনি ব্যবহারকারীকে প্রম্পট করতে পারেন। এমন একটি উদাহরণ যা যেকোনও বিভাগে পড়তে পারে, তার জন্য ঠিকানা গ্রহণ করুন - উদাহরণ-এ মার্কিন যুক্তরাষ্ট্রের বাইরের যাচাই না করা রাস্তার নম্বর দেখুন। |
| ঠিকানা গ্রহণ করুন |
গ্রাহক প্রম্পটের উত্তর না দিলে, আপনার সিস্টেমকে আসল এন্ট্রি গ্রহণ করার অনুমতি দেওয়া একটি ভালো অভ্যাস। |
এইসব ক্ষেত্রে, গ্রাহক এমন কোনও ঠিকানা লিখে থাকতে পারেন যা সিস্টেমে নেই, যেমন নতুন নির্মাণ। |
ঠিকানার তথ্য ঠিক করুন
ফলাফল থেকে যদি স্পষ্ট বোঝা যায় যে ঠিকানায় ডেলিভারি করা যাবে না, তাহলে ঠিকানা ঠিক করুন। আপনার সিস্টেম তখন গ্রাহককে প্রয়োজনীয় তথ্য প্রদান করার জন্য প্রম্পট করতে পারে, যার পরে আপনি ডেলিভারি করা যাবে এমন ঠিকানা পেতে আপনার ওয়ার্কফ্লো পুনরায় ইস্যু করতে পারেন।
সিগন্যাল ঠিক করুন
Address Validation API আপনাকে একাধিক সিগন্যাল প্রদান করে যার মাধ্যমে আপনি জানতে পারেন যে কোনও ঠিকানা ঠিক করা উচিত কিনা।
১. যাচাইকরণের গ্র্যানুলারিটি এবং অনুপস্থিত কম্পোনেন্ট
এই দুটি সিগন্যাল কোনও ঠিকানায় সমস্যা থাকলে তা সবচেয়ে ভালোভাবে ইঙ্গিত করে:
- যখনই
validationGranularityফিল্ডOTHERহয়, আপনার সিস্টেমের উচিত অ্যাড্রেস কম্পোনেন্ট সিগন্যাল ইনভেস্টিগেট করা যাতে কোথায় সমস্যা হয়েছে এবং কীভাবে তা সমাধান করা যায় সেই সম্পর্কে আরও জানা যায়। - পোস্ট-প্রসেস করা
addressঅবজেক্ট যখনই কোনওmissingComponentTypesফিল্ড রিটার্ন করে, আপনার সিস্টেমকে সেই কম্পোনেন্ট চেক করতে হবে। কোনও কম্পোনেন্ট না থাকলে, ঠিকানা অসম্পূর্ণ এবং ডেলিভারি করার অনুপযুক্ত হিসেবে বিবেচিত হয়।
২. অন্যান্য সিগন্যাল
Address Validation API নির্দিষ্ট সমস্যা ডায়াগনসিস করতে সাহায্য করার জন্য অন্যান্য সিগন্যালও প্রদান করে:
| সন্দেহজনক কম্পোনেন্ট | কোনও কম্পোনেন্টের কনফার্মেশন লেভেল enum
UNCOMFIRMED_AND_SUSPICIOUS হলে, কম্পোনেন্টটি ভুল হওয়ার
সম্ভাবনা থাকে।
|
|---|---|
| সমাধান না হওয়া কম্পোনেন্ট | unresolvedToken হল ইনপুটের এমন একটি অংশ যা কোনও ঠিকানার সঠিক অংশ হিসেবে শনাক্ত করা যায়নি। |
৩. মার্কিন যুক্তরাষ্ট্রের ঠিকানা সংক্রান্ত সিগন্যাল
শুধুমাত্র মার্কিন যুক্তরাষ্ট্রের ঠিকানার ক্ষেত্রে প্রযোজ্য কিছু ফিল্ড থেকে বোঝা যায় যে ঠিকানাটি ডেলিভারি করার উপযুক্ত নয় এবং সেটি ঠিক করা প্রয়োজন। যে ঠিকানা ঠিক করতে হবে, সেটির জন্য আপনি নিম্নলিখিত তথ্য দেখতে পাবেন:
dpvConfirmation
|
N, D বা খালি।
|
|---|
dpvConfirmation সম্পর্কে আরও জানতে,
মার্কিন যুক্তরাষ্ট্রের ঠিকানা ম্যানেজ করা দেখুন।
ঠিকানা কনফার্ম করা
আপনি কোনও ঠিকানা কনফার্ম করেন যখন রায় ইঙ্গিত করে যে Address Validation API একটি যাচাই করা ঠিকানা তৈরি করার জন্য ঠিকানা উপাদানে পরিবর্তন করেছে বা অনুমান করেছে। In these cases, you have a deliverable address, but prefer greater confidence that the resulting address is the one intended by the customer.
গ্রাহককে সঠিক প্রম্পট দেখানোর জন্য, আপনার লজিক পরিষেবার মাধ্যমে ফ্ল্যাগ করা কম্পোনেন্ট শনাক্ত করবে, যাতে API কম্পোনেন্টে কোন অ্যাকশন বা ফ্ল্যাগ প্রয়োগ করেছে তা নির্ধারণ করা যায়, যেমন inferred, replaced বা spellCorrected।
রেফারেন্সে AddressComponent দেখুন।
সিগন্যাল কনফার্ম করুন
Address Validation API আপনাকে একাধিক সিগন্যাল প্রদান করে যার মাধ্যমে আপনি জানতে পারেন যে কোনও ঠিকানা কনফার্ম করা উচিত কিনা।
১. যাচাইকরণের গ্র্যানুলারিটি
ROUTE বা তার থেকে ভালো validationGranularity
গ্রহণযোগ্য, তবে PREMISE বা SUBPREMISE
ডেলিভারিযোগ্যতার আরও শক্তিশালী সিগন্যাল প্রদান করে।
২. অন্যান্য সিগন্যাল
গ্রাহকের সাথে ঠিকানা এন্ট্রি কনফার্ম করার সিদ্ধান্ত নেওয়ার সময়, রায়টি নিম্নলিখিতগুলিও প্রদান করে কোন উপাদানগুলি তদন্ত করতে হবে তা নির্ধারণ করতে:
| অনুমান করা ডেটা |
hasInferredComponents ফিল্ডটি true হলে, আপনি বুঝতে পারবেন
যে API অন্যান্য ঠিকানা কম্পোনেন্ট থেকে পাওয়া তথ্য দিয়ে এটি পূরণ করেছে।
|
|---|---|
| পরিবর্তিত ডেটা | যখন
hasReplacedComponents ফিল্ড true হয়, তখন
API, ঠিকানাটি সঠিক করার জন্য, লেখা ডেটার পরিবর্তে এমন ডেটা ব্যবহার করে যা ঠিকানাটি সঠিক করার জন্য উপযুক্ত বলে মনে করে।
|
৩. মার্কিন যুক্তরাষ্ট্রের ঠিকানা সংক্রান্ত সিগন্যাল
মার্কিন যুক্তরাষ্ট্রের ঠিকানার ক্ষেত্রে প্রযোজ্য কিছু ফিল্ড থেকে বোঝা যায় যে আপনার লজিক গ্রাহকের সাথে বিবরণ কনফার্ম করবে। নিম্নলিখিতগুলির মধ্যে যেকোনও একটি প্রযোজ্য:
dpvConfirmation
|
S
|
|---|---|
| ঠিকানা সংক্রান্ত উত্তর | এতে missingComponentTypes ফিল্ড আছে যার ভ্যালু হল
subpremise।
|
ঠিকানা গ্রহণ করুন
আপনি কোনও ঠিকানা তখনই গ্রহণ করেন যখন রায়টি উচ্চ মাত্রার আস্থা প্রদান করে যে ঠিকানাটি ডেলিভারিযোগ্য এবং ডাউনস্ট্রিম প্রসেসে আরও গ্রাহকের ইন্টার্যাকশন ছাড়াই ব্যবহার করা যেতে পারে।
সিগন্যাল গ্রহণ করুন
Address Validation API আপনাকে একাধিক সিগন্যাল প্রদান করে যার মাধ্যমে আপনি জানতে পারেন যে কোনও ঠিকানা কনফার্ম করা উচিত কিনা।
১. যাচাইকরণের গ্র্যানুলারিটি
PREMISE-এর মধ্যে validationGranularity বা তার বেশি স্কোর গ্রহণযোগ্য, তবে কিছু
ক্ষেত্রে, ROUTE স্কোরও ডেলিভারিযোগ্য ঠিকানা নির্দেশ করে।
২. অন্যান্য সিগন্যাল
খুব ভাল কোয়ালিটির ঠিকানা সংক্রান্ত রায়ে নিম্নলিখিত তথ্যও প্রদান করতে হবে:
- কোনও ডেটা পরিবর্তন করা হয়নি। এই ক্ষেত্রে,
hasReplacedComponents: FALSE। - কোনও অনুমান করা কম্পোনেন্ট নেই। এই ক্ষেত্রে,
hasInferredComponents: FALSE।
৩. মার্কিন যুক্তরাষ্ট্রের ঠিকানা সংক্রান্ত সিগন্যাল
মার্কিন যুক্তরাষ্ট্রের ঠিকানার ক্ষেত্রে প্রযোজ্য নির্দিষ্ট কিছু ফিল্ড থেকে বোঝা যায় যে ঠিকানাটি খুব ভাল কোয়ালিটির এবং সেখানে ডেলিভারি করা যাবে। মার্কিন যুক্তরাষ্ট্রের গ্রহণযোগ্য ঠিকানার জন্য, আপনাকে নিম্নলিখিতগুলি দেখতে হবে:
dpvConfirmation
|
Y
|
|---|