Address Validation API 概览

地址验证概览

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

为何使用 Address Validation API

借助 Address Validation API,您可以提高可预测性并减少递送失败,从而提供更出色的客户体验。为此,您可以捕获不良地址并更好地了解地址特征。

如果您不需要验证请求的各个地址组成部分,那么 Geocoding API 可能会更符合您的需求。 Geocoding API 将地址转换为纬度/经度坐标,而 Address Validation API 则验证地址的正确性。如需了解详情,请参阅下文的 Address Validation API 的工作原理以及 Geocoding API 概览

Address Validation API 的用途

借助 Address Validation API,您可以确定某个地址是否引用真实的地点。如果地址未引用实际地点,则 API 可以识别可能错误的组成部分,您可以将其呈现给客户进行更正。下面是一个使用 API 的工作流程示例:

  1. 客户输入地址 - 下图所示简单表单,允许客户输入地址(可能是在结账流程中输入)。
    客户输入的地址。

  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 开始设置。 请先设置您的 Google Cloud 项目,然后按照下方的说明操作。
3 验证地址 先从简单的地址开始,然后提高准确度(仅针对美国和波多黎各的地址)。请参阅验证地址
4 处理回复 Address Validation API 响应提供了两个属性,每个属性都将以不同的方式使用。请参阅了解验证响应
5 提高验证准确性 您可以针对 Address Validation API 响应提供反馈,帮助我们提高地址准确性。请参阅提供地址验证反馈

可用的客户端库

如需查看适用于地址验证 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 认证 TM。🎁?