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

این سند اعتبار آدرس ویژه ایالات متحده را پوشش می دهد:

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

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

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

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

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

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

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

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

ارزش

رفتار

توضیحات

N یا خالی

آدرس رو درست کن

آدرس DPV تایید نشده است.

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

D

آدرس رو درست کن

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

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

اس

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

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

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

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

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

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

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

  • آدرس وارد شده : 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • منطقه : ایالات متحده آمریکا
  • فیلد dpvConfirmation برمی‌گرداند: S

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

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

این مثال از آدرس Googleplex در Mountain View، CA به عنوان یک آدرس با کیفیت شناخته شده استفاده می کند.

  • آدرس وارد شده : 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • منطقه : ایالات متحده آمریکا
  • فیلد dpvConfirmation برمی‌گرداند: Y

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

توجه : DPV نشان نمی‌دهد که آیا Address Validation 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.