Address Validation API 快速参考

Address Validation API 接受地址,识别其组成部分并进行验证,对地址进行标准化处理以方便邮寄,并返回地址的最优纬度/经度坐标。对于美国和波多黎各地址,您可以选择启用 USPS CASS 处理。

Address Validation API:关键信息

  • 产品:Address Validation API
  • 类别:地点
  • 平台:Web 服务 (REST)
  • 运行位置:服务器(后端代码)
  • 发布阶段:GA
  • 生命周期:有效
  • 概览:Address Validation API 概览
  • 适用区域:有限。支持的国家/地区和数据质量因国家/地区而异,部分国家/地区处于预览阶段。系统仅会针对覆盖范围页面上标记的国家/地区返回住宅和商业元数据。USPS CASS 仅适用于美国和波多黎各。(覆盖范围详情)

Address Validation API:何时使用

在以下情况下使用 Address Validation API:

  • 您需要检查地址是否指向真实地点,并找出哪些组成部分缺失或可能不正确。
  • 您需要对地址进行标准化处理并补全地址,以便邮寄,例如在结账流程中。
  • 对于美国或波多黎各境内的地址,您需要通过 USPS CASS 认证的验证和 uspsData。
  • 您需要提供覆盖范围页面上所列国家/地区的住宅或商业地址元数据。

在以下情况下,请勿使用 Address Validation API:

  • 您只需要将地址转换为纬度/经度,而无需验证各个地址组成部分。请改用 Geocoding API。
  • 您需要超本地化的目的地详情,例如建筑物入口、建筑物轮廓或导航点。请改用 Geocoding API。

Address Validation API:设置

官方 Address Validation API 软件包:

  • npm:@googlemaps/addressvalidation
  • pypi:google-maps-addressvalidation
  • go:cloud.google.com/go/maps

Address Validation API:常见错误

  • 问题:当 addressComplete 属性的值为 false 时,该属性会从判定结果中省略,因此预期该字段存在的代码可能会误读不完整的地址。修复方法:将缺失的 addressComplete 属性视为 false,或检查该属性是否存在。请参阅 /maps/documentation/address-validation/understand-response。
  • 问题:如果省略 regionCode,API 会根据地址推断区域,这可能会导致结果不太准确。修正方法:如果您知道 regionCode,请将其添加到 PostalAddress 中。请参阅 /maps/documentation/address-validation/requests-validate-address。
  • 问题:无法保证每个经过验证的美国地址都会完全填充 uspsData 对象。解决方法:不要仅依赖 uspsData 作为验证信号,还要使用判定结果和地址组成部分。请参阅 /maps/documentation/address-validation/handle-us-address。
  • 问题:使用 provideValidationFeedback 发送的反馈必须引用序列中第一个 validateAddress 调用的 responseId,而不是后续调用的。修正方法:存储第一个 validateAddress 响应中的 responseId,并在反馈请求中发送。请参阅 /maps/documentation/address-validation/handle-updated-address。

Address Validation API 的用途

请参阅下面链接的指南,了解每项任务,或在功能探索器中比较不同产品。