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

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

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

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

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

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

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

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

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

  • hasUnconfirmedComponents false باقی مانده است
  • hasInferredComponents false باقی مانده است
  • hasReplacedComponents false باقی مانده است
  • hasSpellCorrectedComponents 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"
}