এই ডকুমেন্টে মার্কিন যুক্তরাষ্ট্রের জন্য নির্দিষ্ট ঠিকানা যাচাইকরণ কভার করা হয়েছে:
- আপনার ওয়ার্কফ্লোতে USPS ডেটা ব্যবহার করা
- USPS ডেলিভারি পয়েন্ট যাচাইকরণ ফিল্ড (dpv)
- সুরক্ষা সম্পর্কিত মেসেজ
আপনার ওয়ার্কফ্লোতে USPS ডেটা
মার্কিন যুক্তরাষ্ট্রে ঠিকানা যাচাই করার সময়, Address Validation API রিটার্নের uspsData অংশও পূরণ করতে পারে।
এই অবজেক্ট সবসময় পপুলেট করা হয় না বলে, ঠিকানা যাচাই করার একমাত্র উপায় হিসেবে এই প্রপার্টির উপর নির্ভর করা উচিত নয়, বরং আপনার সিস্টেমেও ফলাফল ও ঠিকানার কম্পোনেন্ট অন্তর্ভুক্ত করুন।
USPS ডেলিভারি পয়েন্ট যাচাইকরণ (DPV)
uspsData উত্তরের অংশ হিসেবে, dpvConfirmation ফিল্ড একটি একক অক্ষর রিটার্ন করে যাতে আপনি জানতে পারেন যে USPS প্রদত্ত ঠিকানায় ডেলিভারি করতে পারবে কিনা।
আপনি এই ফিল্ড ব্যবহার করে নিম্নলিখিত বিষয়গুলি নির্ধারণ করতে পারবেন:
- ঠিকানার বৈধতা।
- ঠিকানায় সাব-প্রিমিস নম্বর না থাকলে।
- USPS ডেটা সিস্টেমে সাব-প্রিমিস নম্বর না থাকলে।
পরিষেবাটি চারটি dpvConfirmation ভ্যালুর মধ্যে একটি দেখায় অথবা এটি কোনও dpvConfirmation ভ্যালু
দেখায় না। নিচের সারণীতে ৫টি সম্ভাব্য ফলাফলের প্রতিটির জন্য আপনার লজিকের ব্যবহার করা উচিত এমন সাজেস্ট করা
আচরণ দেখানো হয়েছে। এই লজিক সম্পর্কে আরও
বিস্তারিত জানতে, আপনার যাচাইকরণ লজিক তৈরি করুন বিকল্পের মধ্যে থাকা
ওয়ার্কফ্লো ওভারভিউ দেখুন।
মান |
আচরণ |
বিবরণ |
|---|---|---|
না অথবা খালি |
ঠিকানা সংক্রান্ত সমস্যা সমাধান করা |
ঠিকানাটি DPV দ্বারা কনফার্ম করা হয়নি। এর অর্থ হল, USPS, লেখা রাস্তার (রুট) মধ্যে থাকা লেখা প্রাঙ্গণ নম্বরটি চেনে না এবং সেখানে ডেলিভার করতে পারবে না। |
D |
ঠিকানা সংক্রান্ত সমস্যা সমাধান করা |
ঠিকানাটি শুধুমাত্র প্রাথমিক নম্বরের জন্য DPV কনফার্ম করা হয়েছে এবং
সেকেন্ডারি নম্বরের তথ্য অনুপস্থিত ছিল। |
দঃ |
ঠিকানাটি নিশ্চিত করুন |
ঠিকানাটি শুধুমাত্র প্রাথমিক নম্বরের জন্য DPV কনফার্ম করা হয়েছে এবং সেকেন্ডারি নম্বর সংক্রান্ত তথ্য উপস্থিত থাকলেও তা কনফার্ম করা হয়নি। এর অর্থ হল, যে প্রাঙ্গণ নম্বরটি লেখা হয়েছে সেটি লেখা রুটে আছে, কিন্তু যে সাব-প্রাঙ্গণটি লেখা হয়েছে সেটি সেই বিল্ডিংয়ে নেই, USPS-এর তথ্য অনুযায়ী। |
হ্যাঁ |
ঠিকানাটি গ্রহণ করুন |
প্রাথমিক এবং যেকোনও সেকেন্ডারি নম্বরের জন্য ঠিকানাটি DPV কনফার্ম করা হয়েছে। এর অর্থ হল, USPS এই ঠিকানায় সম্পূর্ণভাবে ডেলিভারি করতে পারবে, এর মধ্যে সাব-প্রিমিস নম্বরও অন্তর্ভুক্ত, যদি প্রযোজ্য হয়। |
এই বিভাগের বাকি অংশে বাস্তব জগতের পরিস্থিতি নিয়ে আলোচনা করা হয়েছে যেখানে DPV কোড ব্যবহার করা হয়।
DPV N উদাহরণ - ঠিকানা ঠিক করা
এই উদাহরণে, অন্যথায় সঠিক ঠিকানায় কোনও রাস্তার নম্বর নেই।
- ঠিকানা লেখা হয়েছে: ১২ অ্যাম্ফিথিয়েটার পার্কওয়ে, মাউন্টেন ভিউ, ক্যালিফোর্নিয়া, ৯৪০৪৩
- অঞ্চল: মার্কিন যুক্তরাষ্ট্র
dpvConfirmationফিল্ড থেকে এই ফলাফল পাওয়া যায়:N
এটি একটি অত্যন্ত শক্তিশালী সিগন্যাল যে এই রুটে এই প্রাঙ্গণ নম্বরটি নেই। অন্যান্য সমস্যাযুক্ত ঠিকানার মতো, আপনার সিস্টেমের উচিত ব্যবহারকারীকে সংশোধনের জন্য প্রম্পট করা।
DPV D উদাহরণ - ঠিকানা ঠিক করা
এই উদাহরণে নিউ ইয়র্কে Google অফিসের ঠিকানা ব্যবহার করা হয়েছে, কিন্তু এতে সাব-প্রিমিজ নেই, যা ঠিকানার একটি প্রয়োজনীয় অংশ। সাব-প্রিমিজ সংক্রান্ত তথ্য ছাড়া ডেমোতে ঠিকানা ব্যবহার করে আপনি এটি দেখতে পাবেন।
- ঠিকানা লেখা হয়েছে: 111 8th Avenue, New York, NY, 10011
- অঞ্চল: মার্কিন যুক্তরাষ্ট্র
dpvConfirmationফিল্ড থেকে এই ফলাফল পাওয়া যায়:D
এর থেকে বোঝা যায় যে ইনপুটে সাব-প্রিমিজ উল্লেখ করা হয়নি। Y-এর DPV
পেতে, ইনপুটের অংশ হিসেবে একটি সঠিক সাব-প্রিমিজ অন্তর্ভুক্ত করতে হবে। যেমন,
dpvConfirmation-এর ভ্যালু Y পেতে,
আপনি FL 4 (৪র্থ ফ্লোর)-এর সঠিক সাব-প্রিমিস যোগ করতে পারেন।
DPV S উদাহরণ - ঠিকানা কনফার্ম করুন
এই উদাহরণে এমন একটি সাব-প্রিমিজ নম্বর ব্যবহার করা হয়েছে যা বিল্ডিংয়ের মধ্যে নেই:
- উল্লেখ করা ঠিকানা: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- অঞ্চল: মার্কিন যুক্তরাষ্ট্র
dpvConfirmationফিল্ড থেকে এইসব ভ্যালু পাওয়া যায়:S
এর থেকে বোঝা যায় যে, 1600 Amphitheatre Parkway ঠিকানাটি সঠিক এবং সেখানে চিঠি পাঠানো গেলেও, Ste 101 সাব-প্রিমিসটি এই ঠিকানার সঠিক অংশ নয়। আপনার সিস্টেম ব্যবহারকারীর সাথে এই তথ্য কনফার্ম করবে এবং সংশোধন করার সুযোগ দেবে।
DPV Y উদাহরণ - ঠিকানা গ্রহণ করুন
এই উদাহরণে, Mountain View, CA-তে Googleplex-এর ঠিকানা একটি পরিচিত কোয়ালিটি ঠিকানা হিসেবে ব্যবহার করা হয়েছে।
- উল্লেখ করা ঠিকানা: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
- অঞ্চল: মার্কিন যুক্তরাষ্ট্র
dpvConfirmationফিল্ড থেকে এইসব ভ্যালু পাওয়া যায়:Y
USPS-এর মাধ্যমে ঠিকানাটি সম্পূর্ণভাবে ডেলিভার করা যায়। এটি আপনাকে খুব বেশি মাত্রায় আশ্বস্ত করে যে API ভালো কোয়ালিটির ঠিকানা রিটার্ন করেছে এবং আপনি এটি প্রদান করা তথ্য হিসেবে ব্যবহার করতে পারবেন।
মনে রাখবেন: Address Validation API ইনপুটে কোনও পরিবর্তন করেছে কিনা তা DPV দেখায় না, যেমন বানান সংশোধন।
মার্কিন যুক্তরাষ্ট্রের ঠিকানার জন্য নিরাপত্তা সংক্রান্ত মেসেজ
এই বিভাগে কৃত্রিমভাবে তৈরি করা ঠিকানার জন্য 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.