মার্কিন যুক্তরাষ্ট্রের ঠিকানাগুলি পরিচালনা করুন

এই নথিতে মার্কিন যুক্তরাষ্ট্রের জন্য নির্দিষ্ট ঠিকানা যাচাইকরণ সম্পর্কে আলোচনা করা হয়েছে:

আপনার কর্মপ্রবাহে USPS ডেটা

মার্কিন যুক্তরাষ্ট্রে ঠিকানা যাচাই করার সময়, অ্যাড্রেস ভ্যালিডেশন এপিআই রিটার্নের uspsData অংশটিও পূরণ করতে পারে।

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

ইউএসপিএস ডেলিভারি পয়েন্ট ভেরিফিকেশন (ডিপিভি)

uspsData রেসপন্সের অংশ হিসেবে, dpvConfirmation ফিল্ডটি একটি একক অক্ষর রিটার্ন করে আপনাকে জানিয়ে দেয় যে USPS প্রদত্ত ঠিকানায় ডেলিভারি করতে পারবে কি না।

আপনি এই ক্ষেত্রটি ব্যবহার করে নিম্নলিখিত বিষয়গুলো নির্ধারণ করতে পারেন:

  • ঠিকানার বৈধতা।
  • ঠিকানায় যদি সাব-প্রাঙ্গণ নম্বর না থাকে
  • যদি সাব-প্রেমিস নম্বরটি ইউএসপিএস ডেটা সিস্টেমে বিদ্যমান না থাকে।

সার্ভিসটি হয় চারটি dpvConfirmation ভ্যালুর মধ্যে একটি রিটার্ন করে, অথবা এটি কোনো dpvConfirmation ভ্যালুই রিটার্ন করে না। নিচের টেবিলে ৫টি সম্ভাব্য ফলাফলের প্রতিটির জন্য আপনার লজিকের যে প্রস্তাবিত আচরণটি ব্যবহার করা উচিত, তা দেখানো হয়েছে। এই লজিক সম্পর্কে আরও বিস্তারিত জানতে, 'Build your validation logic'- এর 'Workflow overview' অংশটি দেখুন।

মূল্য

আচরণ

বর্ণনা

এন

অথবা খালি

ঠিকানা ঠিক করুন

ঠিকানাটি ডিপিভি দ্বারা নিশ্চিত করা হয়নি।

এর মানে হলো, USPS প্রবেশ করানো ঠিকানা নম্বরটিকে প্রবেশ করানো রাস্তা (রুট)-এ বিদ্যমান হিসেবে শনাক্ত করতে পারছে না এবং সেখানে ডেলিভারি দিতে পারছে না।

ডি

ঠিকানা ঠিক করুন

ঠিকানাটি শুধুমাত্র প্রাথমিক নম্বরের জন্য ডিপিভি দ্বারা নিশ্চিত করা হয়েছিল এবং দ্বিতীয় নম্বরের তথ্য অনুপস্থিত ছিল।

এর মানে হলো, প্রবেশ করানো ঠিকানা নম্বরটি প্রবেশ করানো রাস্তায় বিদ্যমান, কিন্তু একটি সম্পূর্ণ যাচাইকৃত/বিতরণযোগ্য ঠিকানায় পৌঁছানোর জন্য একটি বৈধ উপ-ঠিকানা নম্বরও প্রদান করতে হবে। অন্য কথায়, ইনপুটে উপ-ঠিকানাটি অনুপস্থিত ছিল।

এস

ঠিকানাটি নিশ্চিত করুন

ঠিকানাটি শুধুমাত্র প্রাথমিক নম্বরের জন্য ডিপিভি দ্বারা নিশ্চিত করা হয়েছিল, এবং দ্বিতীয় নম্বরের তথ্য উপস্থিত থাকলেও তা নিশ্চিত করা হয়নি।

এর মানে হলো, ইউএসপিএস (USPS) অনুসারে, প্রবেশ করানো প্রাঙ্গণ নম্বরটি প্রবেশ করানো রুটে বিদ্যমান, কিন্তু প্রদত্ত উপ-প্রাঙ্গণটি সেই ভবনের মধ্যে বিদ্যমান নেই।

ওয়াই

ঠিকানাটি গ্রহণ করুন

প্রাথমিক এবং যেকোনো দ্বিতীয় নম্বরের জন্য ঠিকানাটি ডিপিভি দ্বারা নিশ্চিত করা হয়েছিল।

এর অর্থ হলো, প্রযোজ্য ক্ষেত্রে সাব-প্রেমিস নম্বর সহ, ঠিকানাটি ইউএসপিএস (USPS) দ্বারা সম্পূর্ণরূপে সরবরাহযোগ্য।

এই অনুচ্ছেদের বাকি অংশে ডিপিভি কোড ব্যবহার করে এমন বাস্তব পরিস্থিতি নিয়ে আলোচনা করা হয়েছে।

DPV N উদাহরণ - ঠিকানাটি ঠিক করুন

এই উদাহরণটিতে অন্যথায় বৈধ একটি ঠিকানায় অস্তিত্বহীন রাস্তার নম্বর ব্যবহার করা হয়েছে।

  • প্রবেশ করানো ঠিকানা : 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • অঞ্চল : মার্কিন যুক্তরাষ্ট্র
  • dpvConfirmation ফিল্ডটি N রিটার্ন করে।

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

ডিপিভি ডি উদাহরণ - ঠিকানা ঠিক করুন

এই উদাহরণে নিউ ইয়র্কে অবস্থিত গুগল অফিস ব্যবহার করা হয়েছে, কিন্তু এতে কোনো সাব-প্রেমিস নেই, যা ঠিকানার একটি আবশ্যক অংশ। সাব-প্রেমিসের তথ্য ছাড়া ডেমোতে ঠিকানাটি ব্যবহার করে আপনি এটি দেখতে পারেন।

  • প্রবেশ করানো ঠিকানা : 111 8th Avenue, New York, NY, 10011
  • অঞ্চল : মার্কিন যুক্তরাষ্ট্র
  • dpvConfirmation ফিল্ডটি D রিটার্ন করে।

এটি নিশ্চিত করে যে ইনপুটে সাব-প্রেমিসটি অনুপস্থিত ছিল। Y-এর একটি DPV পেতে হলে, ইনপুটের অংশ হিসেবে একটি বৈধ সাব-প্রেমিস অন্তর্ভুক্ত থাকতে হবে। উদাহরণস্বরূপ, Y-এর একটি dpvConfirmation মান পেতে আপনি FL 4 (৪র্থ তলা)-এর একটি বৈধ সাব-প্রেমিস অন্তর্ভুক্ত করতে পারেন।

ডিপিভি এস উদাহরণ - ঠিকানা যাচাই করুন

এই উদাহরণে এমন একটি উপ-প্রাঙ্গণ নম্বর ব্যবহার করা হয়েছে যা বিল্ডিংটির মধ্যে বিদ্যমান নেই:

  • প্রবেশ করানো ঠিকানা : ১৬০০ অ্যাম্ফিথিয়েটার পার্কওয়ে, স্যুইট ১০১, মাউন্টেন ভিউ, সিএ, ৯৪০৪৩
  • অঞ্চল : মার্কিন যুক্তরাষ্ট্র
  • dpvConfirmation ফিল্ডটি ফেরত দেয়: S

এর থেকে বোঝা যায় যে, যদিও ১৬০০ অ্যাম্ফিথিয়েটার পার্কওয়ে একটি ঠিকানা হিসেবে বিদ্যমান যেখানে ডাক গ্রহণ করা যায়, কিন্তু এর অন্তর্ভুক্ত স্যুইট ১০১ ঠিকানাটির একটি বৈধ অংশ নয়। আপনার সিস্টেমের উচিত ব্যবহারকারীর কাছ থেকে এই তথ্যটি যাচাই করে নেওয়া এবং এটি সংশোধনের সুযোগ দেওয়া।

DPV Y উদাহরণ - ঠিকানাটি গ্রহণ করুন

এই উদাহরণে ক্যালিফোর্নিয়ার মাউন্টেন ভিউতে অবস্থিত গুগলপ্লেক্সের ঠিকানাটিকে একটি পরিচিত ও মানসম্মত ঠিকানা হিসেবে ব্যবহার করা হয়েছে।

  • প্রবেশ করানো ঠিকানা : ১৬০০ অ্যাম্ফিথিয়েটার পার্কওয়ে, মাউন্টেন ভিউ, সিএ, ৯৪০৪৩
  • অঞ্চল : মার্কিন যুক্তরাষ্ট্র
  • dpvConfirmation ফিল্ডটি Y রিটার্ন করে।

এই ঠিকানাটি ইউএসপিএস (USPS) দ্বারা সম্পূর্ণরূপে ডেলিভারিযোগ্য। এর ফলে আপনি অত্যন্ত নিশ্চিত হতে পারেন যে এপিআই (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.