Address Validation API 是一项接受地址的服务。它可识别地址组成部分并对其进行验证。它还会对邮寄地址进行标准化,并查找其最已知的经纬度坐标。(可选)对于美国和波多黎各的地址,您可以启用编码准确性支持系统 (CASSTM)。
为何使用 Address Validation API
借助 Address Validation 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 提供的资源及其返回的数据。如需了解具体详情,请参阅 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 的可用客户端库列表,请参阅客户端库。
关于 CASSTM
United States Postal Service® (USPS®)1 维护着 Coding Accuracy Support System (CASSTM),以支持和认证地址验证服务提供商。CASS CertifiedTM 服务(例如 Address Validation API)已得到证实,因为它能够填充地址中缺少的信息、对其进行标准化并对其进行更新,从而为您提供最新、最准确的地址。
默认情况下,CASS 处于停用状态,并且仅对“US”和“PR”区域支持。如需启用 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®、CASSTM、CASS CertifiedTM。↩