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

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

نمونه رایج: پذیرفتن

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

نشانی واردشده منطقه
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"
}