Address Validation API 概览

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 的工作流示例：

1. Customer input an address（客户输入地址）- 下图显示了可让客户输入地址的简单表单，可能是结账流程的一部分。
   

2. 应用将地址发送到 API - 应用将此地址作为输入传递给 Address Validation API。

3. API 对地址进行验证和标准化 - Address Validation API 会在响应中返回 API 确定的完整地址，或指出信息缺失的位置。

4. 客户更正或确认推荐的地址 - 根据 API 返回的内容，您可以向客户提供以下提示：

   • 提供建议的地址以供客户确认：
     

   • 提示客户添加缺失的信息：
     

   • 如果 API 由于信息缺失或信息不正确而无法验证输入地址，则提示用户修正地址：
     

Address Validation API 的工作原理

地址验证接受 POST 请求，其地址采用 JSON 正文的形式。它会将地址分成各个部分，然后执行以下检查和更正：

• 正确 - 提供组件级验证检查，包括子场所（如果有）。
• 完成 - 尝试推断地址组成部分缺失或不正确。
• 格式正确 - 清理并标准化地址组成部分的格式。

试用演示版，了解 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 简介

美国邮政服务® (USPS®)¹ 维护着编码准确性支持系统 (CASSTM)，以便为地址验证提供商提供支持和认证。CASS CertifiedTM 服务（例如 Address Validation API）已得到确认，可以填充地址中缺失的信息、对其进行标准化并进行更新，从而为您提供最新、最准确的地址。

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

作为我们使用 USPS 服务的一部分，USPS 会评估针对人为创建的地址的要求。如果 USPS 发现输入地址是人为创建的，Google 需要停止验证客户地址，并且必须向 USPS 报告客户的联系信息（姓名和地址）、相关输入地址以及汇总的使用情况数据。使用 API 即表示您同意本服务专用条款。

后续步骤

• 查看常见问题解答：前往常见问题解答
• 查看覆盖范围：请参阅国家/地区和区域详情
• 处理大量地址：请参阅使用 Address Validation API 处理大量地址