Address Validation API 概览

地址验证概览

Address Validation API 是一项接受地址的服务。它会识别地址组成部分并对其进行验证。它还会对邮寄地址进行标准化,并查找该地址的最佳已知纬度/经度坐标。(可选)对于美国和波多黎各的地址,您可以启用编码准确性支持系统 (CASSTM)

为何使用 Address Validation API

借助 Address Validation API,您可以提高送货可预测性并减少送货失败情况,从而改善客户体验。为此,您可以捕获错误地址并更好地了解地址特征。

如果您不需要验证单独的地址组成部分,Geocoding API 可能更符合您的需求。Geocoding API 将地址转换为纬度/经度坐标,而 Address Validation API 验证地址的正确性。如需了解详细比较,请参阅架构中心中的使用 Google Maps Platform 构建位置验证功能

Address Validation API 的用途

借助 Address Validation API,您可以确定某个地址是否指向真实地点。如果地址指的不是实际地点,该 API 就能识别出可能有误的部分,并向客户出示以进行更正。以下是使用此 API 的工作流示例:

  1. Customer 请输入地址 - 下图显示了一个简单的表单,可让客户输入地址,可能是在结账流程中进行。
    客户输入的地址。

  2. 应用将地址发送到 API - 应用将此地址作为输入传递给 Address Validation API。

  3. API 对地址进行验证和标准化 - 在响应中,Address Validation API 会返回该 API 确定的完整地址,或指明信息缺失的位置。

  4. 客户更正或确认建议的地址 - 根据 API 返回的内容,您可以向客户提供以下提示:

    • 提供推荐的地址以供客户确认:
      请客户确认由 API 确定的地址。

    • 提示客户添加缺失的信息:
      提示客户输入缺失的地址信息。

    • 如果 API 由于信息缺失或信息不正确而无法验证输入地址,则提示用户修正地址:
      提示客户更正地址信息。

Address Validation API 的运作方式

地址验证接受具有 JSON 正文形式的地址的 POST 请求。它会将地址拆分为各个部分,然后执行以下检查和更正:

  • 正确 - 提供组件级验证检查,包括子部署(如果有)。
  • 完成 - 尝试推断地址组成部分缺失或不正确。
  • 格式规范 - 清理地址组成部分的格式并对其进行标准化。

试用演示版,了解 Address Validation API 的实际运用。

资源

下表总结了 Address Validation API 提供的资源及其返回的数据。如需了解具体详情,请参阅 Address Validation API 参考文档

数据资源 返回的数据

JSON 格式的地址组成部分。

请参阅验证地址

经过验证的完整地址(如果可能)。

每个地址组成部分的验证状态。

如果地址可用,请执行以下操作:

  • 地理编码
  • 地址精确度
  • 邮政服务数据(如果有)。

请参阅了解验证响应

如何使用 Address Validation API

1 试用演示版 使用各种地址表单(包括正确和错误)探索演示。 此演示提供了一种有用的方法来探索服务的返回值以及采用 JSON 格式的 API 响应。
2 检查覆盖率 查看覆盖范围详情,了解 Address Validation API 支持哪些国家和地区。
3 进行设置 设置您的 Google Cloud 项目开始,按照说明操作。
4 请求验证地址 先使用一个简单的地址,然后为提高准确性,您可以启用 CASS(仅适用于美国和波多黎各的地址)。请参阅请求验证地址
5 处理响应 Address Validation API 响应提供两个属性,每个属性的使用方式各不相同。 请参阅了解基本响应
6 提高验证准确性 您可以通过提供有关 Address Validation API 响应的反馈来提高地址准确性。请参阅处理更新后的地址

可用的客户端库

如需查看 Address Validation API 的可用客户端库列表,请参阅客户端库

CASSTM 简介

美国邮政服务® (USPS®)1 维护编码准确性支持系统 (CASSTM),以便为地址验证服务提供商提供支持和认证。CASS CertifiedTM 服务(例如 Address Validation API)已得到确认,能够填充地址中缺失的信息、对其进行标准化和更新,从而为您提供最新、最准确的地址。

CASS 默认处于停用状态,只有“US”和“PR”地区支持它。如需启用 CASS,请在验证请求中将 enableUspsCass 设置为 true。如需了解详情,请参阅验证地址

作为使用 USPS 服务的一部分,USPS 会评估针对人为创建的地址提出的要求。如果 USPS 发现输入地址是人为创建的,Google 需要停止验证客户地址,并且必须向 USPS 报告客户的联系信息(姓名和地址)、相关输入地址以及汇总的使用情况数据。使用 API 即表示您同意接受这些服务专用条款

后续步骤


  1. Google Maps Platform 是美国邮政服务® 的非独家被许可人。以下商标归美国邮政服务® 所有,经许可后使用:美国邮政服务®、CASSTM、CASS CertifiedTM。