Address Validation API 是一项可接受地址、标识地址组成部分并对其进行验证的服务。此外,它还会将邮寄地址标准化,并找到它最熟悉的经纬度。它有助于了解某个地址是否指向真实的地点。如果地址未引用真实地点,它可以识别可能错误的组成部分,让用户能够更正这些地址。
Address Validation API 提供了许多功能来帮助您处理地址,包括:
将地址分成各个组成部分,然后提供组件级验证检查,包括子营业地点(如果有)。
清理、标准化和推断缺失或不正确的地址组成部分。
为地址补充其他信息,包括地理编码、地址精确度和邮政服务数据。
返回一个字符串,其中包含由 API 确定的完整地址。
试用演示版,了解 Address Validation API 的实际运用。
将 Address Validation API 添加到您的工作流
Address Validation API 的最常见用例之一是确保客户提供正确的地址,从而提升客户体验。地址验证有助于捕获不良地址,减少递送失败的情况,同时提高地址特征的感知能力,从而提高递送可预测性。
下图显示了允许客户输入地址的简单表单(可能作为结账流程的一部分)。将此地址作为输入传递给 Address Validation API。
在响应中,Address Validation 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 即表示您同意这些服务专用条款。