本文档介绍了许多实际情况, 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
表示地址的情况
需要进一步调查的质量问题。这些示例还
说明您的逻辑如何从判定结果传输到地址组成部分
以获得更全面的了解,从而增强您的系统逻辑。
非美国且未经确认的门牌号
此示例展示了意大利境内的地址条目以及所有地址组成部分
并且没有推断的或被替换的组件。不过,
validationGranularity
为 ROUTE
。
已输入地址 | 区域 |
---|---|
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"
}
<ph type="x-smartling-placeholder">
美国门牌号(未经确认)
此示例展示了美国地址的条目以及所有地址组成部分
且没有任何推断的或被替换的组件。不过,
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",
}
<ph type="x-smartling-placeholder">
已确认地址的 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"
}
<ph type="x-smartling-placeholder">。