为何使用 Address Validation API
借助地址验证 API,您可以提高送货可预测性并减少送货失败情况,从而提升客户体验。为此,您需要捕获错误的地址,并更好地了解地址特征。
如果您不需要验证各个地址组成部分,Geocoding API 可能更适合您的需求。Geocoding API 可将地址转换为纬度和经度坐标。Address Validation API 会验证地址的正确性。如需进行详细比较,请参阅架构中心中的使用 Google Maps Platform 构建位置验证功能。
您可以使用 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 提供的资源以及该 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 的可用客户端库列表,请参阅客户端库。
CASS™ 简介
美国邮政服务® (USPS®)1 负责维护编码准确性支持系统 (CASS™),以支持和认证地址验证服务提供商。CASS 认证™服务(例如地址验证 API)已经验证,能够填充地址缺失的信息、对其进行标准化和更新,以便为您提供最新、最准确的地址。
CASS 默认处于停用状态,并且仅适用于“美国”和“波多黎各”地区。如需启用 CASS,请在验证请求中将 enableUspsCass
设置为 true
。如需了解详情,请参阅验证地址。
在我们使用 USPS 服务的过程中,USPS 会评估人工创建的地址的相关请求。如果 USPS 认定输入地址是人为创建的,Google 必须停止为客户验证地址,并必须向 USPS 报告客户的联系信息(姓名和地址)、相关输入地址和汇总的使用情况数据。使用此 API 即表示您同意这些服务条款。
后续步骤
- 查看常见问题解答:前往常见问题解答
- 查看覆盖区域:请参阅国家/地区和区域覆盖范围详情
- 处理大量地址:请参阅使用 Address Validation API 处理大量地址
-
Google Maps Platform 是 United States Postal Service® 的非独家许可人。以下商标归 United States Postal Service® 所有,并已获得许可:United States Postal Service®、CASS™、CASS Certified™。↩