Address Validation API 概览

Address Validation API 是一项可接受地址、标识地址组成部分并对其进行验证的服务。此外,它还会将邮寄地址标准化,并找到它最熟悉的经纬度。它有助于了解某个地址是否指向真实的地点。如果地址未引用真实地点,它可以识别可能错误的组成部分,让用户能够更正这些地址。

Address Validation API 提供了许多功能来帮助您处理地址,包括:

  • 将地址分成各个组成部分,然后提供组件级验证检查,包括子营业地点(如果有)。

  • 清理、标准化和推断缺失或不正确的地址组成部分。

  • 为地址补充其他信息,包括地理编码、地址精确度和邮政服务数据。

  • 返回一个字符串,其中包含由 API 确定的完整地址。

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

将 Address Validation API 添加到您的工作流

Address Validation API 的最常见用例之一是确保客户提供正确的地址,从而提升客户体验。地址验证有助于捕获不良地址,减少递送失败的情况,同时提高地址特征的感知能力,从而提高递送可预测性。

下图显示了允许客户输入地址的简单表单(可能作为结账流程的一部分)。将此地址作为输入传递给 Address Validation API。

客户输入的地址。

在响应中,Address Validation API 会返回由该 API 确定的完整地址。将完整的地址作为建议地址提供给客户:

由 API 确定的地址。

如果 Address Validation API 检测到信息缺失,请提示用户添加该信息:

提示客户输入缺失地址信息的表单。

如果由于信息缺失或不正确,API 无法验证输入地址,请提示用户修复该地址:

提示客户更正地址信息的表单。

Address Validation API 和 Geocoding API 之间的区别

Geocoding API 和 Address Validation API 都会尝试回答“用户输入的最佳位置是什么?”这一问题。与 Geocoding API 不同,Address Validation API 还尝试:

  • 回答“此用户输入是否表示真实地址?”这个问题。
  • 了解输入地址,即使它的某些部分无法与可用数据匹配
  • 针对不同组成部分的有效性提供反馈
  • 验证地址是否完整,并标记缺少的任何必要组件
  • 设置所返回地址的格式,以便于邮寄

例如,假设某个地址为“123 Fake St, Mountain View, CA”,Geocoding API 只会返回加利福尼亚州山景城的地理编码,而忽略“123 Fake St”,因为 Mountain View 中没有这样的街道(或类似名称的街道)。

另一方面,Address Validation API 可以识别“123”是门牌号,“Fake St”是一条街道,并返回包含这些组成部分并将它们标记为未确认的结果,为您提供信号,表明地址可能无法进行地理编码的原因。

CASSTM 简介

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

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

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

后续步骤

如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。

最后更新时间 (UTC):2023-03-27。