نشانی‌های ایالات متحده را مدیریت کنید

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

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

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

لزوماً به‌طور کامل تکمیل نمی‌شود.

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

درستی‌سنجی نقطه‌ای تحویل USPS (DPV)

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

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

  • اعتبار نشانی.
  • اگر شماره زیرساخت از نشانی حذف شده باشد.
  • اگر شماره زیرساخت در سیستم داده USPS وجود نداشته باشد.

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

مقدار

رفتار

شرح

شمال

یا خالی

اصلاح نشانی

نشانی DPV تأیید نشد.

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

ر

اصلاح نشانی

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

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

جنوب

نشانی را تأیید کنید

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

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

س

پذیرفتن نشانی

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

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

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

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

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

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

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

DPV D example - fix the address

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

  • نشانی واردشده: 111 8th Avenue, New York, NY, 10011
  • منطقه: ایالات متحده امریکا
  • فیلد dpvConfirmation برمی‌گرداند: D

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

نمونه DPV S - تأیید نشانی

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

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

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

مثال DPV Y - پذیرفتن نشانی

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

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

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

توجه: DPV نشان نمی‌دهد که آیا «میانای برنامه‌سازی کاربردی درستی‌سنجی نشانی» تغییری در ورودی ایجاد کرده است یا نه، مثلاً املای کلمه را اصلاح کرده است یا نه.

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

این بخش پرچم‌های امنیتی ارائه‌شده در داده‌های 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.