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

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

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

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

آدرس وارد شده منطقه
خیابان کاخ باکینگهام، پلاک ۷۶، لندن، 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 است.

آدرس وارد شده منطقه
۹۷۵ کارسون درایو، سانی‌ویل، کالیفرنیا ۹۴۰۸۶ ما

داده‌های 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 نیست.

آدرس وارد شده منطقه
۱۵۵ از طریق جاده کاندادو، پالم بیچ گاردنز، فلوریدا ۳۳۴۱۸-۱۷۰۳ ما

حکم برای آدرس تأیید شده با داده‌های ناقص 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"
}