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

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

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

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

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

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

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

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

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

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

ارزش

رفتار

شرح

شمال

یا خالی

اصلاح نشانی

نشانی با DPV تأیید نشده است.

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

ر

اصلاح نشانی

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

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

جنوب

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

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

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

س

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

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

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

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

DPV N example - fix the address

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

  • نشانی واردشده: 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 قابل‌تحویل است. این امر به شما اطمینان بسیار بالایی می‌دهد که میانای برنامه‌سازی کاربردی نشانی‌ای با کیفیت خوب برگردانده است و می‌توانید از آن همان‌طور که ارائه شده است استفاده کنید.

توجه: 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.