মার্কিন যুক্তরাষ্ট্রের ঠিকানা ম্যানেজ করা

এই ডকুমেন্টে মার্কিন যুক্তরাষ্ট্রের জন্য নির্দিষ্ট ঠিকানা যাচাইকরণ কভার করা হয়েছে:

আপনার ওয়ার্কফ্লোতে USPS ডেটা

মার্কিন যুক্তরাষ্ট্রে ঠিকানা যাচাই করার সময়, Address Validation API রিটার্নের uspsData অংশও পূরণ করতে পারে।

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

USPS ডেলিভারি পয়েন্ট যাচাইকরণ (DPV)

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

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

  • ঠিকানার বৈধতা।
  • ঠিকানায় সাব-প্রিমিজ নম্বর না থাকলে।
  • USPS ডেটা সিস্টেমে সাব-প্রিমিস নম্বর না থাকলে।

পরিষেবাটি চারটি dpvConfirmation ভ্যালুর মধ্যে একটি দেখায় অথবা এটি কোনও dpvConfirmation ভ্যালু দেখায় না। নিচের সারণীতে ৫টি সম্ভাব্য ফলাফলের প্রতিটির জন্য আপনার লজিকের ব্যবহার করা উচিত এমন সাজেস্ট করা আচরণ দেখানো হয়েছে। এই লজিক সম্পর্কে আরও বিবরণ জানতে, আপনার যাচাইকরণ লজিক তৈরি করুন লিঙ্কে গিয়ে ওয়ার্কফ্লো ওভারভিউ দেখুন।

ভ্যালু

আচরণ

বিবরণ

না

অথবা খালি

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

ঠিকানাটি DPV দ্বারা কনফার্ম করা হয়নি।

এর অর্থ হল, USPS-এর কাছে আপনার লেখা রাস্তার (রুট) জন্য লেখা প্রাঙ্গণ নম্বরটি পরিচিত নয় এবং সেখানে ডেলিভারি করা যাবে না।

D

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

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

এর অর্থ হল, যে রাস্তার নাম লেখা হয়েছে সেখানে প্রাঙ্গণ নম্বরটি আছে, তবে সম্পূর্ণ যাচাই করা/ডেলিভারি করা যাবে এমন ঠিকানায় পৌঁছাতে, একটি সঠিক সাব-প্রাঙ্গণ নম্বরও দিতে হবে। অন্যভাবে বলতে গেলে, ইনপুটে সাব-প্রিমিস ছিল না।

দঃ

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

ঠিকানাটি শুধুমাত্র প্রাথমিক নম্বরের জন্য DPV কনফার্ম করা হয়েছে এবং সেকেন্ডারি নম্বরের তথ্য উপস্থিত ছিল কিন্তু কনফার্ম করা হয়নি।

এর অর্থ হল, যে রুট লেখা হয়েছে সেখানে প্রাঙ্গণের নম্বরটি আছে, কিন্তু USPS-এর তথ্য অনুযায়ী, যে সাব-প্রাঙ্গণ লেখা হয়েছে সেটি সেই বিল্ডিংয়ের মধ্যে নেই।

হ্যাঁ

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

প্রাথমিক এবং যেকোনও সেকেন্ডারি নম্বরের জন্য ঠিকানাটি DPV কনফার্ম করা হয়েছে।

এর অর্থ হল, USPS এই ঠিকানায় সম্পূর্ণভাবে ডেলিভারি করতে পারবে, এর মধ্যে সাব-প্রিমিস নম্বরও অন্তর্ভুক্ত, যদি প্রযোজ্য হয়।

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

DPV N example - fix the address

এই উদাহরণে, সঠিক ঠিকানায় রাস্তার নম্বরটি ভুল দেওয়া হয়েছে।

  • ঠিকানা লেখা হয়েছে: ১২ অ্যাম্ফিথিয়েটার পার্কওয়ে, মাউন্টেন ভিউ, ক্যালিফোর্নিয়া, ৯৪০৪৩
  • অঞ্চল: মার্কিন যুক্তরাষ্ট্র
  • dpvConfirmation ফিল্ড থেকে এই ফলাফল পাওয়া যায়: N

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

DPV D example - fix the address

এই উদাহরণে নিউ ইয়র্কের 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-এর ঠিকানা একটি পরিচিত কোয়ালিটি ঠিকানা হিসেবে ব্যবহার করা হয়েছে।

  • ঠিকানা লেখা হয়েছে: ১৬০০ Amphitheatre Parkway, Mountain View, CA, ৯৪০৪৩
  • অঞ্চল: মার্কিন যুক্তরাষ্ট্র
  • 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.