本文档介绍了一些实际场景，其中 Address Validation API 提供的响应信号需要系统执行修正行为。如需了解背景信息，请参阅构建验证逻辑中的工作流程概览。
常见示例：修复
本部分介绍了 Address Validation API 提供响应信号来表明地址信息质量较低的常见示例。
缺少城市和邮政编码
此示例展示了一个仅包含街道地址、不含城市或邮政编码的条目。
| 输入的地址 | 区域 |
|---|---|
| 21 45 40th street | USA |
缺少城市和邮政编码的判定结果
以下示例突出显示了响应中的重要信号。
{
"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, 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 匹配，合理表示组件数据可能仍然有效。
缺少子媒体资源
此场景描述了仅缺少相应子建筑物（例如公寓号或部门号）的地址。否则，Address Validation API 可以完整验证地址。与缺少任何地址组成部分的情况一样，addressComplete 为 false，因此在人工检查判定结果时不会显示。
举例来说，假设客户输入了旧金山市评估员办公室的有效地址，但输入中缺少门牌号。
| 输入的地址 | 区域 |
|---|---|
| 1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 | USA |
缺少子前提的判定结果
在此示例中，判定结果不会显示 addressComplete 属性，因此其值为 false。因此，您知道至少有一个地址元素意外、未解析或缺失。
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true
}
address 查询会显示以下内容：
"missingComponentTypes": [
"subpremise"
]
经过进一步调查，USPS 数据提供了 D 的 dpvConfirmation 代码，这也表明缺少相应子建筑物。