本文档介绍了许多实际场景,在这些场景中,Address Validation API 提供可保证您的系统接受行为的响应信号。如需了解上下文,请参阅使用验证响应中的工作流概览。
常见示例:接受
此场景说明了您的系统可以接受客户输入的地址的地址。
已输入地址 | 区域 |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ | 英国 |
可接受地址的判定
以下示例突出显示了重要信号。
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
除此之外,该响应还指示以下信息:
hasUnconfirmedComponents
仍然为false
hasInferredComponents
仍然为false
hasReplacedComponents
仍然为false
当这些信号组合在一起时,表示地址是优质地址。
极端情况示例:接受
以下示例涵盖 verdict
指出解决了需要进一步调查的质量问题的情况。这些示例还说明了您的逻辑如何从判定结果转到地址组成部分,从而更全面地了解信息,从而增强您的系统逻辑。
非美国且未确认的门牌号
下例说明了在输入意大利地址时,所有地址组成部分均存在,但没有推断或替换的组成部分。不过,validationGranularity
为 ROUTE
。
已输入地址 | 区域 |
---|---|
Via Fonte Grugnale,14 单元 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"
}