本文档介绍了许多真实场景,在这些场景中,Address Validation API 提供可保证系统采取fix行为的响应信号。如需了解上下文,请参阅构建验证逻辑中的工作流概览。
常见示例:修正
本部分介绍了一些常见示例,在这些示例中,Address Validation API 提供指示地址信息质量较低的响应信号。
缺少城市和邮政编码
此示例说明一个条目仅包含街道地址,没有城市或邮政编码。
已输入地址 | 区域 |
---|---|
第 21 45 40 街 | 美国 |
缺少城市和邮政编码的认定结果
以下示例强调了来自该响应的重要信号。
{
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true
}
这些信号表明地址不可送达,因此您可以查询 addressComponents
了解详情:
{
"componentName": {
"text": "21",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "45 40th street",
"languageCode": "en"
},
"componentType": "route",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "United States",
"languageCode": "en"
},
"componentType": "country",
"confirmationLevel": "CONFIRMED"
}
Address Validation API 仅以 CONFIRMED
的形式返回国家/地区(美国)。它以 UNCONFIRMED_BUT_PLAUSIBLE
的形式返回所有其他地址组成部分,但不包括某些数据(例如市行政区和邮政编码)。
缺少门牌号
此示例显示缺少门牌号。
已输入地址 | 区域 |
---|---|
伦敦白金汉宫路 SW1W 9TQ | 英国 |
缺少门牌号的认定结果
{
"inputGranularity": "PREMISE_PROXIMITY",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE"
}
validationGranularity
为 ROUTE
,表示与街道匹配,但信息不足,无法到达场所。此外,判定结果中缺少 addressComplete
属性,因此它是 false
。进一步查询 address
对象会发现缺少组件类型:
"missingComponentTypes": [
"street_number"
]
极端案例示例:修复
在某些情况下,您是要修正、确认还是接受地址,取决于您的特定业务场景。以下示例说明了未严格归入修复类别的场景。
门牌号未确认
在这种情况下,Address Validation API 无法确认提供的门牌号,但表示地址是完整的。
已输入地址 | 区域 |
---|---|
84 Buckingham Palace Road, SW1W 9TQ, London | 英国 |
针对未确认的门牌号码的认定结果
以下示例强调了重要信号。
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE_PROXIMITY",
"geocodeGranularity": "PREMISE_PROXIMITY",
"addressComplete" : true,
"hasUnconfirmedComponents": true
}
结合利用验证粒度这一组合,您可以仅研究场所级的近似值以及未经确认的组件。查询 addressComponents
属性会显示以下未经确认的 componentType
:
{
"componentName": {
"text": "84",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
在这里,street_number
的 confirmation_level
设置为 UNCONFIRMED_BUT_PLAUSIBLE
。“未确认”表示服务无法与其数据集中的门牌号 84 相匹配,“合理”表示组件数据可能仍然有效。
缺少 subpremise
此场景描述了仅缺少 subpremise 的地址,例如公寓或部门编号。否则,Address Validation API 可以完全验证地址。与缺少任何地址组成部分的情况一样,addressComplete
为 false
,因此在手动检查认定结果时不存在。
为便于说明,假设客户输入了旧金山市评估员办公室的有效地址,但在输入内容中缺少房间号。
已输入地址 | 区域 |
---|---|
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 | 美国 |
针对缺少 subpremise 的判定结果
在此示例中,认定结果未显示 addressComplete
属性,因此为 false
。因此,您知道至少有一个地址元素异常、未解析或缺失。
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true
}
address
查询会显示以下内容:
"missingComponentTypes": [
"subpremise"
]
经过进一步调查,USPS 数据提供了 D
的 dpvConfirmation
代码,这也表明缺少 subpremise。