本文档介绍了 Address Validation API 提供的响应信号,这些信号保证您的系统可以进行fix行为。如需了解背景信息,请参阅构建验证逻辑中的工作流概览。
常见示例:fix
本部分介绍了一些常见示例,在这些示例中,Address Validation API 提供的响应信号指示的是低质量地址信息。
缺少城市和邮政编码
下例展示的条目仅包含街道地址,而不包含城市或邮政编码。
已输入地址 | 区域 |
---|---|
第 40 大街 21 45 号 | 美国 |
针对缺少城市和邮政编码的判定
以下示例强调了响应中的重要信号。
{
"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
,但数据中缺少一些重要的信息,例如市行政区和邮政编码。
缺少门牌号
此示例展示了缺失的门牌号。
已输入地址 | 区域 |
---|---|
白金汉宫路 (Buckingham Palace Road, SW1W 9TQ London) | 英国 |
缺少门牌号的判定
{
"inputGranularity": "PREMISE_PROXIMITY",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE"
}
validationGranularity
为 ROUTE
,表示与街道匹配,但信息不足,无法到达营业地点。此外,判定结果中缺少 addressComplete
属性,因此为 false
。如果进一步查询 address
对象,就会发现缺少的组件类型:
"missingComponentTypes": [
"street_number"
]
极端情况示例:修复
在某些情况下,是修正、确认还是接受地址取决于您的特定业务场景。以下示例说明了可能并不完全属于某个修复类别的情形。
门牌号未经确认
在这种情况下,Address Validation API 无法确认所提供的门牌号,但仍表示地址完整。
已输入地址 | 区域 |
---|---|
伦敦 84 Buckingham Palace Road, SW1W 9TQ | 英国 |
对未经确认的门牌号的裁定
以下示例强调了一些重要信号。
{
"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。