پذیرفتن نشانی - نمونه‌ها

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

مثال رایج: پذیرفتن

این سناریو نشانی‌ای را نشان می‌دهد که سیستم شما نشانی واردشده توسط مشتری را می‌پذیرد.

نشانی واردشده	منطقه
76 Buckingham Palace Road, London SW1W 9TQ	بریتانیا

حکم برای نشانی قابل‌قبول

مثال زیر نشان‌های مهم را برجسته می‌کند.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

علاوه‌براین، verdict نشان‌دهنده موارد زیر است:

• hasUnconfirmedComponents false باقی مانده است
• ‫hasInferredComponents باقی مانده است false
• ‫hasReplacedComponents باقی مانده است false

وقتی این سیگنال‌ها باهم ترکیب شوند، نشان‌دهنده نشانی با کیفیت بالا هستند.

نمونه‌های مورد لبه‌ای: پذیرفتن

مثال‌های زیر موقعیت‌هایی را پوشش می‌دهد که در آن verdict نشان‌دهنده مشکلات کیفیت نشانی است که نیاز به بررسی بیشتر دارد. این مثال‌ها همچنین نشان می‌دهند که چگونه منطق شما می‌تواند از رأی به مؤلفه‌های نشانی منتقل شود تا تصویر کامل‌تری برای بهبود منطق سیستم شما به‌دست آید.

پلاک تأییدنشده غیرامریکایی

این مثال نشان می‌دهد که نشانی ایتالیایی با همه عناصر نشانی موجود، بدون عناصر استنباطی یا جایگزین‌شده وارد شده است. بااین‌حال، validationGranularity ROUTE است.

نشانی وارد شد	منطقه
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia	فناوری اطلاعات

رأی برای شماره خیابان تأییدنشده

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

تحقیقات بیشتر درباره عناصر نشانی نشان می‌دهد که سطح تأیید برای شماره خیابان UNCONFIRMED_BUT_PLAUSIBLE است.

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

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

این مثال نشان می‌دهد که نشانی ایالات متحده با همه عناصر نشانی وارد شده است و هیچ عنصری استنباط یا جایگزین نشده است. بااین‌حال، validationGranularity PREMISE_PROXIMITY است.

نشانی واردشده	منطقه
975 Carson Dr, Sunnyvale, CA 94086	ایالات متحده

داده‌های USPS برای شماره خیابان تأییدنشده

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

داده‌های ناقص USPS برای نشانی تأییدشده

این مثال ورود نشانی ایالات متحده را با همه عناصر نشانی تأییدشده، بدون عناصر استنباطی یا جایگزین‌شده، و validationGranularity از PREMISE نشان می‌دهد. بااین‌حال، uspsData به‌طور کامل پر نشده است و مقدار dpvConfirmation را ندارد.

نشانی وارد شد	منطقه
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703	ایالات متحده

رأی برای نشانی تأییدشده با داده‌های USPS ناقص

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true,
}

داده‌های USPS برای نشانی تأییدشده با داده‌های USPS ناقص

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}