为何使用 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 的工作流程示例:
客户输入地址 - 下图所示简单表单,允许客户输入地址(可能是在结账流程中输入)。
应用将地址发送到 API - 应用将此地址作为输入传递给 Address Validation API。
API 验证地址并对其进行标准化 - 在响应中,Address Validation API 会返回 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 即表示您同意这些服务专用条款。
后续步骤
- 查看常见问题解答:转到常见问题解答
- 查看覆盖范围:请参阅国家和地区覆盖范围的详细信息
- 处理大量地址:请参阅使用 Address Validation API 处理大量地址
-
Google Maps Platform 是美国邮政®的非独家被许可人。以下商标由美国邮政® 所有并经许可使用:美国邮政®、CASSTM、CASS 认证 TM。🎁?