接受地址 - 示例

本文档介绍了许多实际情况, Address Validation API 提供可保证接受行为的响应信号 来自你的系统请参阅 工作流程概述使用验证响应作为上下文。

常见示例:accept

此场景说明您的系统会接受一个地址, 客户输入的地址

已输入地址 区域
伦敦白金汉宫路 76 号,SW1W 9TQ 英国

判定地址是否可接受

以下示例突出显示了重要信号。

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

除此之外,响应还指示以下内容:

  • hasUnconfirmedComponents 仍然为 false
  • hasInferredComponents 仍然为 false
  • hasReplacedComponents 仍然为 false

这些信号组合在一起时表示地址质量较高。

<ph type="x-smartling-placeholder">

极端情况示例:接受

以下示例涵盖了 verdict 表示地址的情况 需要进一步调查的质量问题。这些示例还 说明您的逻辑如何从判定结果传输到地址组成部分 以获得更全面的了解,从而增强您的系统逻辑。

非美国且未经确认的门牌号

此示例展示了意大利境内的地址条目以及所有地址组成部分 并且没有推断的或被替换的组件。不过, validationGranularityROUTE

已输入地址 区域
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia (意大利) IT

对未经确认的门牌号的裁定

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

进一步调查地址组成部分后发现街道 编号为 UNCONFIRMED_BUT_PLAUSIBLE

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

美国门牌号(未经确认)

此示例展示了美国地址的条目以及所有地址组成部分 且没有任何推断的或被替换的组件。不过, validationGranularityPREMISE_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"
}