本文档介绍了许多真实场景,在这些场景中,Address Validation API 提供的响应信号可确保您的系统实现 accept 行为。如需了解背景信息,请参阅使用验证响应中的工作流概览。
常见示例:accept
此场景展示了您的系统会接受客户输入的地址的地址。
已输入地址 | 区域 |
---|---|
伦敦白金汉宫路 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 (意大利) | IT |
对未经确认的门牌号的裁定
{
"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"
}