آدرس های ایالات متحده را مدیریت کنید

این سند اعتبارسنجی آدرس مخصوص ایالات متحده را پوشش می‌دهد:

داده‌های USPS در گردش کار شما

هنگام اعتبارسنجی آدرس‌ها در ایالات متحده، API اعتبارسنجی آدرس می‌تواند بخش uspsData از خروجی را نیز پر کند.

از آنجا که این شیء همیشه پر نمی‌شود، نباید به این ویژگی به عنوان تنها وسیله برای اعتبارسنجی آدرس‌ها تکیه کنید، بلکه باید اجزای حکم و آدرس را نیز در سیستم خود بگنجانید.

تأیید نقطه تحویل USPS (DPV)

به عنوان بخشی از پاسخ uspsData ، فیلد dpvConfirmation یک کاراکتر واحد را برمی‌گرداند تا به شما اطلاع دهد که آیا USPS می‌تواند به آدرس ارائه شده تحویل دهد یا خیر.

با استفاده از این فیلد می‌توانید موارد زیر را تعیین کنید:

  • اعتبار آدرس.
  • اگر شماره تلفن محل سکونت فرعی در آدرس وجود نداشته باشد.
  • اگر شماره شعبه فرعی در سیستم داده USPS وجود نداشته باشد.

این سرویس یا یکی از چهار مقدار dpvConfirmation را برمی‌گرداند یا اصلاً مقداری dpvConfirmation را برنمی‌گرداند. جدول زیر رفتار پیشنهادی منطق شما را برای هر یک از 5 نتیجه ممکن نشان می‌دهد. برای جزئیات بیشتر در مورد این منطق، به نمای کلی گردش کار در بخش «ساخت منطق اعتبارسنجی» مراجعه کنید.

ارزش

رفتار

توضیحات

ن

یا خالی

آدرس را اصلاح کنید

آدرس توسط DPV تأیید نشده بود.

این یعنی USPS شماره سفارش وارد شده در خیابان (مسیر) وارد شده را تشخیص نمی‌دهد و نمی‌تواند به آنجا تحویل دهد.

دی

آدرس را اصلاح کنید

آدرس فقط برای شماره اصلی توسط DPV تأیید شده بود و اطلاعات شماره ثانویه وجود نداشت.

این بدان معناست که شماره تلفن محل مورد نظر در خیابان وارد شده وجود دارد، اما برای رسیدن به یک آدرس کاملاً تأیید شده/قابل تحویل، یک شماره تلفن محل فرعی معتبر نیز باید ارائه شود. به عبارت دیگر، محل فرعی در ورودی وجود نداشته است.

س

آدرس را تأیید کنید

آدرس فقط برای شماره اصلی توسط DPV تأیید شد و اطلاعات شماره ثانویه وجود داشت اما تأیید نشد.

طبق گفته USPS، این بدان معناست که شماره پیش‌فرض وارد شده در مسیر وارد شده وجود دارد، اما فرضیه فرعی ارائه شده در آن ساختمان وجود ندارد.

ی

آدرس را بپذیرید

آدرس برای شماره‌های اصلی و فرعی توسط DPV تأیید شد.

این بدان معناست که آدرس به طور کامل توسط USPS قابل تحویل است، از جمله شماره فرعی، در صورت وجود.

ادامه‌ی این بخش به سناریوهای دنیای واقعی که از کدهای DPV استفاده می‌کنند، می‌پردازد.

مثال DPV N - آدرس را اصلاح کنید

این مثال از شماره خیابانی که وجود ندارد در یک آدرس معتبر استفاده می‌کند.

  • آدرس وارد شده : ۱۲ آمفی تئاتر پارک وی، مانتین ویو، کالیفرنیا، ۹۴۰۴۳
  • منطقه : ایالات متحده آمریکا
  • فیلد dpvConfirmation N را برمی‌گرداند.

این یک سیگنال بسیار قوی است که نشان می‌دهد این شماره پیش‌فرض در این مسیر وجود ندارد. همانند سایر آدرس‌های مشکل‌دار، سیستم شما باید از کاربر بخواهد که اصلاحات را انجام دهد.

مثال DPV D - آدرس را اصلاح کنید

این مثال از دفتر گوگل در نیویورک استفاده می‌کند، اما شامل یک زیرمجموعه که بخش الزامی آدرس است، نمی‌شود. می‌توانید این را با استفاده از آدرس در نسخه آزمایشی بدون اطلاعات زیرمجموعه مشاهده کنید.

  • آدرس وارد شده : خیابان هشتم، پلاک ۱۱۱، نیویورک، نیویورک، کد پستی ۱۰۰۱۱
  • منطقه : ایالات متحده آمریکا
  • فیلد dpvConfirmation D را برمی‌گرداند.

این تأیید می‌کند که فرض فرعی از ورودی حذف شده است. برای رسیدن به DPV برابر با Y، یک فرض فرعی معتبر باید به عنوان بخشی از ورودی گنجانده شود. به عنوان مثال، می‌توانید یک فرض فرعی معتبر از FL 4 (طبقه چهارم) را برای به دست آوردن مقدار dpvConfirmation برابر با Y وارد کنید.

مثال DPV S - آدرس را تأیید کنید

این مثال از شماره فرعی استفاده می‌کند که در ساختمان وجود ندارد:

  • آدرس وارد شده : ۱۶۰۰ آمفی تئاتر پارک وی، سوئیت ۱۰۱، مانتین ویو، کالیفرنیا، ۹۴۰۴۳
  • منطقه : ایالات متحده آمریکا
  • فیلد dpvConfirmation S را برمی‌گرداند.

این نشان می‌دهد که اگرچه آدرس ۱۶۰۰ Amphitheatre Parkway به عنوان آدرسی وجود دارد که می‌تواند نامه را بپذیرد، اما زیرمجموعه Ste 101 بخش معتبری از آدرس نیست. سیستم شما باید این اطلاعات را با کاربر تأیید کند و فرصتی برای اصلاح فراهم کند.

مثال DPV Y - آدرس را بپذیرید

این مثال از آدرس گوگل‌پلکس در مانتین ویو، کالیفرنیا به عنوان یک آدرس با کیفیت شناخته شده استفاده می‌کند.

  • آدرس وارد شده : ۱۶۰۰ آمفی تئاتر پارک وی، مانتین ویو، کالیفرنیا، ۹۴۰۴۳
  • منطقه : ایالات متحده آمریکا
  • فیلد dpvConfirmation مقدار Y را برمی‌گرداند.

این آدرس کاملاً توسط USPS قابل تحویل است. این به شما اطمینان بسیار بالایی می‌دهد که API آدرسی با کیفیت خوب را برگردانده است و می‌توانید از آن همانطور که ارائه شده است استفاده کنید.

نکته : DPV نشان نمی‌دهد که آیا API اعتبارسنجی آدرس، تغییری در ورودی، مانند اصلاح املا، ایجاد کرده است یا خیر.

پیام‌های امنیتی برای آدرس‌های ایالات متحده

این بخش، پرچم‌های امنیتی ارائه شده در داده‌های USPS برای آدرس‌های مصنوعی ایجاد شده را پوشش می‌دهد. این اقدام امنیتی برای جلوگیری از ایجاد مصنوعی لیست آدرس‌ها طراحی شده است، به این صورت که تشخیص می‌دهد چه زمانی یک آدرس ارسالی به صورت مصنوعی ساخته شده و از راه قانونی به دست نیامده است. این اتفاق باید بسیار نادر باشد.

وقتی USPS یک آدرس مصنوعی ایجاد شده را شناسایی می‌کند، فیلد errorMessage از ویژگی uspsData پاسخ حاوی یک پیام خطا است که مشکل را شرح می‌دهد. برای مثال:

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.