地址验证概览

欧洲经济区 (EEA) 开发者

为何要在 Maps JavaScript API 中使用 Address Validation？

Address Validation 库将地址作为输入，以识别和验证地址组成部分。它还会对地址进行标准化处理以方便邮寄，并找到地址的最优纬度/经度坐标。（可选）对于美国和波多黎各的地址，您可以启用 编码准确性支持系统 (CASS™)。

借助 Address Validation API，您可以提高送达可预测性并减少送达失败的情况，从而改善客户体验。 为此，您需要捕获无效地址，并更好地了解地址特征。

您可以使用 Maps JavaScript API 中的 Address Validation API 执行哪些操作

借助 Maps JavaScript API 中的 Address Validation，您可以确定地址是否指向真实地点。如果地址不是指真实地点，API 可以识别可能错误的组成部分，您可以向客户展示这些组成部分以供更正。以下是一个工作流程示例：

  1. 客户输入地址 - 下图显示了一个基本表单，客户可以在其中输入地址，这可能是结账流程的一部分。

    客户输入的地址。

  2. 应用将地址发送到 API - 应用使用 fetchAddressValidation 方法传递此地址。

  3. API 验证并标准化地址 - Address Validation API 会在其响应中返回由 API 确定的完整地址，或指明缺少哪些信息。

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

    1. 确认建议的地址。
    2. 提供缺失的信息。
    3. 修正地址。
    客户可以确认更正后的地址。 客户可以提供缺失的信息。 客户可以更正地址。

Maps JavaScript API 中的 Address Validation 的运作方式

当调用 fetchAddressValidation 时，API 会尝试执行以下操作：

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

CASS™ 简介

美国邮政服务公司 (USPS®)1 负责维护 编码准确性支持系统 (CASS™)，以支持和认证地址验证服务提供商。经过 CASS Certified™ 认证的服务（例如地址验证 API）已通过确认，能够填写地址中缺失的信息、对地址进行标准化处理并更新地址，从而为您提供最新且最准确的地址。

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

在您使用 USPS 服务的过程中，USPS 会评估人工创建的地址请求。如果 USPS 发现某个输入地址是人为创建的，Google 必须停止为相应客户验证地址，并且必须向 USPS 报告该客户的联系信息（姓名和地址）、相关输入地址以及汇总的使用情况数据。使用此 API 即表示您同意遵守这些 服务专用条款。

后续步骤

  1. Google Maps Platform 是美国邮政服务® 的非独占被许可方。以下商标归美国邮政服务® 所有，并经许可使用：United States Postal Service®、CASS™、CASS Certified™。 ↩