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

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

• আপনার কর্মপ্রবাহে USPS ডেটা ব্যবহার করা
• ইউএসপিএস ডেলিভারি পয়েন্ট ভেরিফিকেশন ফিল্ড (ডিপিভি)
• নিরাপত্তা বার্তা

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

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

মূল পয়েন্ট: যদি আপনার সিস্টেম প্রাথমিকভাবে বা একচেটিয়াভাবে মার্কিন ঠিকানাগুলি পরিচালনা করে, আপনি এই প্রতিক্রিয়া বস্তুটিকে আপনার চেকিং যুক্তিতে রেফারেন্সের প্রথম পয়েন্ট হিসাবে ব্যবহার করতে নির্বাচন করতে পারেন। যাইহোক, এটা জানা গুরুত্বপূর্ণ যে পরিষেবা দ্বারা যাচাইকৃত প্রতিটি ঠিকানার জন্য 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.

দ্রষ্টব্য: যখন uspsData একটি কৃত্রিম ঠিকানা নির্দেশ করে, তখন ঠিকানা যাচাইকরণ API প্রতিক্রিয়ার অন্যান্য বৈশিষ্ট্যের প্রতিক্রিয়া অপ্রভাবিত থাকে।