এই নথিতে মার্কিন যুক্তরাষ্ট্রের জন্য নির্দিষ্ট ঠিকানা যাচাইকরণ অন্তর্ভুক্ত রয়েছে:
- আপনার কর্মপ্রবাহে USPS ডেটা ব্যবহার করা
- USPS ডেলিভারি পয়েন্ট যাচাইকরণ ক্ষেত্র (dpv)
- নিরাপত্তা বার্তা
আপনার কর্মপ্রবাহে USPS ডেটা
মার্কিন যুক্তরাষ্ট্রে ঠিকানা যাচাই করার সময়, ঠিকানা যাচাইকরণ API রিটার্নের uspsData অংশটিও পূরণ করতে পারে।
যেহেতু এই অবজেক্টটি সবসময় পূর্ণ থাকে না, তাই ঠিকানা যাচাই করার একমাত্র উপায় হিসেবে আপনার এই বৈশিষ্ট্যের উপর নির্ভর করা উচিত নয়, বরং আপনার সিস্টেমে রায় এবং ঠিকানা উপাদানগুলিও অন্তর্ভুক্ত করা উচিত।
USPS ডেলিভারি পয়েন্ট ভেরিফিকেশন (DPV)
uspsData রেসপন্সের অংশ হিসেবে, dpvConfirmation ফিল্ডটি একটি অক্ষর ফেরত দেয় যা আপনাকে জানাবে যে USPS প্রদত্ত ঠিকানায় ডেলিভারি করতে পারবে কিনা।
আপনি নিম্নলিখিতগুলি নির্ধারণ করতে এই ক্ষেত্রটি ব্যবহার করতে পারেন:
- ঠিকানার বৈধতা।
- যদি ঠিকানা থেকে একটি সাব-প্রাইমাইজ নম্বর অনুপস্থিত থাকে।
- যদি USPS ডেটা সিস্টেমে সাব-প্রিমিস নম্বরটি বিদ্যমান না থাকে।
এই পরিষেবাটি হয় চারটি dpvConfirmation মানের মধ্যে একটি প্রদান করে, অথবা এটি মোটেও dpvConfirmation মান প্রদান করে না। নীচের সারণীতে ৫টি সম্ভাব্য ফলাফলের প্রতিটির জন্য আপনার লজিকের ব্যবহার করা উচিত এমন প্রস্তাবিত আচরণ দেখানো হয়েছে। এই লজিক সম্পর্কে আরও বিস্তারিত জানার জন্য, Build your validation logic- এ Workflow ওভারভিউ দেখুন।
মূল্য | আচরণ | বিবরণ |
|---|---|---|
ন অথবা খালি | ঠিকানা ঠিক করুন | ঠিকানাটি DPV দ্বারা নিশ্চিত করা হয়নি। এর অর্থ হল USPS প্রবেশ করানো রাস্তায় (রুটে) বিদ্যমান প্রবেশ করানো প্রিমিস নম্বরটি চিনতে পারে না এবং সেখানে ডেলিভারি করতে পারে না। |
দ | ঠিকানা ঠিক করুন | ঠিকানাটি শুধুমাত্র প্রাথমিক নম্বরের জন্য DPV নিশ্চিত করা হয়েছিল, এবং দ্বিতীয় নম্বরের তথ্য অনুপস্থিত ছিল। |
স | ঠিকানা নিশ্চিত করুন | ঠিকানাটি শুধুমাত্র প্রাথমিক নম্বরের জন্য DPV নিশ্চিত করা হয়েছিল, এবং দ্বিতীয় নম্বরের তথ্য উপস্থিত ছিল কিন্তু নিশ্চিত করা হয়নি। এর অর্থ হল যে প্রবেশ করানো প্রাইম নম্বরটি প্রবেশ করানো রুটে বিদ্যমান, কিন্তু প্রদত্ত উপ-প্রাইমটি সেই ভবনের মধ্যে বিদ্যমান নেই, USPS অনুসারে। |
স | ঠিকানাটি গ্রহণ করুন | ঠিকানাটি প্রাথমিক এবং যেকোনো মাধ্যমিক সংখ্যার জন্য DPV নিশ্চিত করা হয়েছিল। এর অর্থ হল ঠিকানাটি USPS দ্বারা সম্পূর্ণরূপে সরবরাহযোগ্য, যদি প্রযোজ্য হয় তবে সাব-প্রিমিস নম্বর সহ। |
এই বিভাগের বাকি অংশে DPV কোড ব্যবহার করে এমন বাস্তব বিশ্বের পরিস্থিতি নিয়ে আলোচনা করা হয়েছে।
DPV N উদাহরণ - ঠিকানা ঠিক করুন
এই উদাহরণে অন্যথায় বৈধ ঠিকানায় অস্তিত্বহীন রাস্তার নম্বর ব্যবহার করা হয়েছে।
- ঠিকানাটি প্রবেশ করানো হয়েছে : 12 অ্যাম্ফিথিয়েটার পার্কওয়ে, মাউন্টেন ভিউ, সিএ, 94043
- অঞ্চল : মার্কিন যুক্তরাষ্ট্র
-
dpvConfirmationক্ষেত্রটি প্রদান করে:N
এটি একটি অত্যন্ত শক্তিশালী সংকেত যে এই রুটে এই প্রিমাইজ নম্বরটি বিদ্যমান নেই। অন্যান্য সমস্যাযুক্ত ঠিকানাগুলির মতো, আপনার সিস্টেমটি ব্যবহারকারীকে সংশোধনের জন্য অনুরোধ করবে।
DPV D উদাহরণ - ঠিকানা ঠিক করুন
এই উদাহরণটি নিউ ইয়র্কে অবস্থিত গুগল অফিস ব্যবহার করে, কিন্তু এতে কোনও সাব-প্রিমিস নেই যা ঠিকানার একটি প্রয়োজনীয় অংশ। আপনি সাব-প্রিমিস তথ্য ছাড়াই ডেমোতে ঠিকানাটি ব্যবহার করে এটি দেখতে পারেন।
- ঠিকানাটি প্রবেশ করানো হয়েছে : 111 8th Avenue, New York, NY, 10011
- অঞ্চল : মার্কিন যুক্তরাষ্ট্র
-
dpvConfirmationক্ষেত্রটি প্রদান করে:D
এটি নিশ্চিত করে যে ইনপুট থেকে সাব-প্রাইমাইজটি অনুপস্থিত ছিল। Y এর DPV পেতে, ইনপুটের অংশ হিসাবে একটি বৈধ সাব-প্রাইমাইজ অন্তর্ভুক্ত করতে হবে। উদাহরণস্বরূপ, Y এর dpvConfirmation মান পেতে আপনি FL 4 (4র্থ তলা) এর একটি বৈধ সাব-প্রাইমাইজ অন্তর্ভুক্ত করতে পারেন।
DPV S উদাহরণ - ঠিকানা নিশ্চিত করুন
এই উদাহরণে একটি সাব-প্রাইমাইজ নম্বর ব্যবহার করা হয়েছে যা ভবনের মধ্যে বিদ্যমান নেই:
- ঠিকানাটি প্রবেশ করানো হয়েছে : ১৬০০ অ্যাম্ফিথিয়েটার পার্কওয়ে, স্যুট ১০১, মাউন্টেন ভিউ, সিএ, ৯৪০৪৩
- অঞ্চল : মার্কিন যুক্তরাষ্ট্র
-
dpvConfirmationক্ষেত্রটি ফেরত দেয়:S
এর থেকে বোঝা যায় যে, ১৬০০ অ্যাম্ফিথিয়েটার পার্কওয়ে এমন একটি ঠিকানা হিসেবে বিদ্যমান যেখানে ডাকযোগে ডাক গ্রহণ করা যায়, কিন্তু সাব-প্রিমিস স্টে ১০১ ঠিকানার বৈধ অংশ নয়। আপনার সিস্টেমের উচিত ব্যবহারকারীর সাথে এই তথ্য নিশ্চিত করা এবং সংশোধনের সুযোগ প্রদান করা।
DPV Y উদাহরণ - ঠিকানা গ্রহণ করুন
এই উদাহরণে মাউন্টেন ভিউ, ক্যালিফোর্নিয়ার গুগলপ্লেক্স ঠিকানাটি একটি পরিচিত মানের ঠিকানা হিসেবে ব্যবহার করা হয়েছে।
- ঠিকানাটি প্রবেশ করানো হয়েছে : ১৬০০ অ্যাম্ফিথিয়েটার পার্কওয়ে, মাউন্টেন ভিউ, সিএ, ৯৪০৪৩
- অঞ্চল : মার্কিন যুক্তরাষ্ট্র
-
dpvConfirmationক্ষেত্রটি প্রদান করে:Y
ঠিকানাটি USPS দ্বারা সম্পূর্ণরূপে সরবরাহযোগ্য। এটি আপনাকে খুব উচ্চ মাত্রার আত্মবিশ্বাস দেয় যে APIটি ভাল মানের ঠিকানাটি ফেরত দিয়েছে, এবং আপনি এটি প্রদত্ত হিসাবে ব্যবহার করতে পারেন।
দ্রষ্টব্য : DPV নির্দেশ করে না যে ঠিকানা যাচাইকরণ API ইনপুটে কোনও পরিবর্তন করেছে কিনা, যেমন বানান সংশোধন।
মার্কিন ঠিকানার জন্য নিরাপত্তা বার্তা
এই বিভাগটি কৃত্রিমভাবে তৈরি ঠিকানার জন্য USPS ডেটাতে প্রদত্ত সুরক্ষা পতাকাগুলি কভার করে। এই সুরক্ষা ব্যবস্থাটি একটি ঠিকানা তালিকার কৃত্রিম সৃষ্টি রোধ করার জন্য ডিজাইন করা হয়েছে যখন জমা দেওয়া ঠিকানাটি কৃত্রিমভাবে তৈরি করা হয়েছে এবং বৈধভাবে প্রাপ্ত হয়নি বলে মনে হয়। এটি একটি খুব বিরল ঘটনা হওয়া উচিত।
যখন USPS কৃত্রিমভাবে তৈরি একটি ঠিকানা শনাক্ত করে, তখন প্রতিক্রিয়ার uspsData সম্পত্তির errorMessage ক্ষেত্রে সমস্যাটি বর্ণনা করে একটি ত্রুটি বার্তা থাকে। উদাহরণস্বরূপ:
AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.