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

এই নথিটি মার্কিন যুক্তরাষ্ট্রের জন্য নির্দিষ্ট ঠিকানার বৈধতা কভার করে:

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

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

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

USPS ডেলিভারি পয়েন্ট ভেরিফিকেশন (DPV)

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

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

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

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

মান

আচরণ

বর্ণনা

এন বা খালি

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

ঠিকানা DPV নিশ্চিত করা হয়নি.

এর মানে ইউএসপিএস প্রবেশ করা রাস্তায় (রুটে) বিদ্যমান প্রবেশ করা প্রিমাইজ নম্বরটিকে চিনতে পারে না এবং সেখানে বিতরণ করতে পারে না।

ডি

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

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

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

এস

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

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

এর মানে হল যে প্রিমাইস নম্বর প্রবেশ করানো রুটে বিদ্যমান, কিন্তু ইউএসপিএস অনুসারে প্রদত্ত সাব-প্রিমিস সেই বিল্ডিংয়ের মধ্যে বিদ্যমান নেই।

Y

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

প্রাথমিক এবং যেকোনো মাধ্যমিক নম্বরের জন্য ঠিকানাটি DPV নিশ্চিত করা হয়েছে।

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

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

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

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

  • ঠিকানা দেওয়া হয়েছে : 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • অঞ্চল : মার্কিন যুক্তরাষ্ট্র
  • dpvConfirmation ফিল্ড রিটার্ন করে: N

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

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

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

  • ঠিকানা দেওয়া হয়েছে : 111 8th Avenue, New York, NY, 10011
  • অঞ্চল : মার্কিন যুক্তরাষ্ট্র
  • dpvConfirmation ফিল্ড রিটার্ন করে: D

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

DPV S উদাহরণ - ঠিকানা নিশ্চিত করুন

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

  • ঠিকানা দেওয়া হয়েছে : 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • অঞ্চল : মার্কিন যুক্তরাষ্ট্র
  • dpvConfirmation ফিল্ড রিটার্ন করে: S

এটি ইঙ্গিত করে যে, 1600 অ্যাম্ফিথিয়েটার পার্কওয়ে একটি ঠিকানা হিসাবে বিদ্যমান যা মেল গ্রহণ করতে পারে, সাব-প্রিমিস স্টে 101 ঠিকানাটির একটি বৈধ অংশ নয়। আপনার সিস্টেমের উচিত ব্যবহারকারীর সাথে এই তথ্য নিশ্চিত করা এবং একটি সংশোধনের সুযোগ প্রদান করা।

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

এই উদাহরণটি মাউন্টেন ভিউ, CA-এর Googleplex ঠিকানাটিকে পরিচিত গুণমানের ঠিকানা হিসেবে ব্যবহার করে।

  • ঠিকানা দেওয়া হয়েছে : 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • অঞ্চল : মার্কিন যুক্তরাষ্ট্র
  • dpvConfirmation ফিল্ড রিটার্ন করে: Y

ঠিকানাটি USPS দ্বারা সম্পূর্ণরূপে বিতরণযোগ্য। এটি আপনাকে অত্যন্ত উচ্চ মাত্রার আত্মবিশ্বাস দেয় যে API ভাল মানের একটি ঠিকানা ফেরত দিয়েছে এবং আপনি এটি প্রদত্ত হিসাবে ব্যবহার করতে পারেন।

দ্রষ্টব্য : DPV নির্দেশ করে না যে ঠিকানা যাচাইকরণ API ইনপুটে কোনো পরিবর্তন করেছে, যেমন একটি বানান সংশোধন।

মার্কিন ঠিকানার জন্য নিরাপত্তা বার্তা

এই বিভাগে কৃত্রিমভাবে তৈরি ঠিকানাগুলির জন্য 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.