آدرس را قبول کنید - نمونه ها

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

مثال رایج: قبول

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

آدرس وارد شد منطقه
76 جاده کاخ باکینگهام، لندن SW1W 9TQ انگلستان

حکم برای یک آدرس قابل قبول

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

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

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

  • 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 of 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"
}