选择地址验证解决方案

目标

地址验证功能可为各种使用情形提供价值，除了测试结果的原始质量之外，还有一些关键注意事项，建议您加以了解。例如：在用户流程（如地点自动补全和 Google 地图）中全面了解兼容产品、区域可用性以及企业信任度和可靠性。

在评估地址验证 API 时，我们建议您在测试过程中遵循以下准则。

此测试的目标是：

1. 确认 Address Validation API 适合您的使用情形。
2. 验证 Address Validation API 如何满足您的解决方案要求，例如：
   • 确定优质地址。
   • 提醒您解决输入源质量不佳的问题。
   • 对地址数据进行更正，包括推理、替换和拼写更正。
   • 提供格式化的配送地址。
   • 针对子地址数据缺失或不正确情况发出提醒（仅限美国）。
3. 确保实施该 API 会带来可衡量的益处。

执行测试后，您将能够回答上述问题，并确定该 API 是否适合您的业务。

准备数据

您应针对现有地址数据样本执行测试。不要手动挑选测试数据，而是选择能代表您开展业务的地理位置的随机样本。这意味着，如果您在美国和英国都有业务，但 70% 的业务是在英国开展的，只有 30% 的业务是在美国开展的，那么样本应反映这种比例。

使用捕获时的地址。例如，如果您计划在电子商务结账流程中实现地址验证，请使用客户在表单中输入的地址，而不要使用任何可能被实现地址验证 API 所取代的现有处理流程。

准备大约 5,000-10,000 条记录的样本量以进行测试。

调用该 API

本部分的前提条件：了解如何 发送地址验证请求。

准备好数据后，您需要针对 API 运行每个地址记录。

如需有关如何调用该 API 的指南，请参阅 Address Validation API 文档。我们还提供了一篇文章，介绍了使用 Address Validation API 处理大量地址的最佳实践。

此步骤的输出应该是 API 针对每个地址记录输出的数据。然后，您就可以分析结果，确定该 API 是否适合您的使用情形。您可以使用电子表格、数据库或其他工具。

查看结果

本部分的先决条件：了解如何 处理验证响应，尤其是“修复”“确认”和“接受”的概念。

在本部分中，我们将讨论您可能需要分析的输出方案，以评估解决方案的适用性。

本文档中讨论的关键 API 字段概览

查看有效地址

对 API 返回的数据进行排序，以确定您的系统会接受哪些地址作为有效地址。需要从 API 中查找的关键信号包括：

• verdict.validationGranularity 包含 PREMISE 或更高级别的。
• verdict.addressComplete 为 true。
• 无推断或替换的组件。

如需了解详情，请参阅接受地址。

此练习的输出应为地址数据的一个子集，该子集会被您的系统接受为有效数据。此时，您可以确定以下内容：

• 接受百分比是否可接受？
• 如果您使用现有的地址验证工作流，接受率是否相当或更高？

示例：有效地址

判定

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

查看无效地址

此步骤可让您手动检查一些被标记为无效的地址数据，并查看在不使用 Address Validation API 的情况下，这些无效地址是否会导致下游问题。

对从 API 返回的数据进行排序，以确定系统会标记为无效的地址集。需要从 API 中查找的关键信号包括：

• verdict.validationGranularity 设置为 OTHER 或 ROUTE，具体取决于您的风险级别。
• verdict.addressComplete 为 false。

如需了解详情，请参阅更正地址。

此练习的输出应为会被您的系统标记为无效的地址数据子集。此时，您可以确定无效百分比是否可接受。

请务必注意，将地址标记为无效是 Address Validation API 的核心功能，而将地址标记为无效的比例较高并不一定意味着该 API 的效果不佳。该 API 会告知您地址存在问题，从而让您能够更早地发现错误，避免下游出现问题，提高工作效率。

示例：地址无效

判定

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

查看缺失或未确认的组件

在此阶段，您还可以查看缺失或未确认的组件。这是返回内容中 Address 对象的一部分。这两个字段分别是 missingComponentTypes 和 unconfirmedComponentTypes。

您可以使用这些字段来帮助检测 API 将地址标记为无效的原因，并通过将不正确的特定字段反馈给数据收集点，来收集正确的地址信息，从而使地址有效。这是 API 通过提供有关数据质量的具体信息来体现价值的一种方式。

示例：缺少且未确认的组件

判定

{
     "inputGranularity": "ROUTE",
     "validationGranularity": "OTHER",
     "geocodeGranularity": "OTHER",
     "hasUnconfirmedComponents": true
}

缺少和未确认的组件

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

查看已修正的地址

Address Validation API 能够更正输入数据，将可能无效的地址输入转换为有效的地址数据。这是 API 增加价值的一种方式，在测试中务必要考虑到这一点。

需要注意的关键信号包括：

• inferred、replaced 或 spellCorrected 在任何 addressComponents 上设置为 true。
• verdict.hasInferredComponents，或将 verdict.hasReplacedComponents 设置为 true。

如需了解详情，请参阅确认地址。

本练习的输出应为已通过 API 应用更正的地址数据的子集。

您可以手动查看部分此类数据，以确定该 API 是否正在对您的数据进行修正，从而减少下游工作流程中的摩擦。

示例：包含更正的地址

路线 addressComponent

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[仅限美国] 查看缺少或包含不正确子地址数据的地址

对于美国地址，Address Validation API 能够确定子地址是缺失还是不正确。

需要注意的关键信号包括：

• 在 Address 对象中：
  • “unconfirmedComponentTypes”包含“subpremise”
  • “missingComponentTypes”包含“subpremise”
• 在 UspsData 对象中：
  • dpvConfirmation 为 D（缺少子前提）
  • dpvConfirmation 为 S（次前提未确认）

如需了解详情，请参阅处理美国地址。

此测试将显示您的数据中是否存在缺少或不正确的子场所（例如公寓号码）的问题。这可能会导致下游问题，尤其是在配送用例中。地址验证 API 可在工作流程中更早地识别出此类问题，从而帮助您采取相应步骤来收集更正后的数据，进而提升工作流程的价值。

示例：缺少次前提

缺少组件

"missingComponentTypes": [
    "subpremise"
]

美国邮政服务 (USPS) 数据 DPV 确认

"dpvConfirmation": "D"

[仅限美国] 查看 USPS 标准化地址

Address Validation API 还会针对美国地址返回 USPS 标准化地址。如果您需要在配送标签上打印 USPS 格式的地址，这一点尤为重要。

您可以查看 UspsAddress，了解这些数据，并确定它们是否能为您的工作流带来价值。

示例：USPS 标准化地址

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

总结

立即开始测试 - 立即开始测试 Address Validation API，确保地址数据的准确性，提升客户体验，并简化业务运营。按照上述测试方案进行测试后，您将获得所需的信息，从而确定地址验证 API 是否能为您的工作流程带来价值。

建议的延伸阅读内容：

• Address Validation API 开发者文档
• 使用 Address Validation API 大批量处理地址
• 电子商务结账流程中的地址验证

贡献者

Henrik Valve | DevX 工程师