地址验证概览

欧洲经济区 (EEA) 开发者

为何在 Maps JavaScript API 中使用地址验证？

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

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

Maps JavaScript API 中的地址验证功能

借助 Maps JavaScript API 中的地址验证功能，您可以确定某个地址是否对应真实地点。如果地址并非真实地点，该 API 可以识别可能错误的组成部分，以便您向客户展示并更正。以下是一个示例工作流：

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

    客户输入的地址。

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

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

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

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

Maps JavaScript API 中的地址验证功能的工作原理

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

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

关于 CASS™

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

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

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

后续步骤

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