修正地址 - 示例

本文档介绍了许多真实场景，在这些场景中，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。