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:设置
- 要启用的服务:
addressvalidation.googleapis.com - 身份验证:API 密钥、OAuth 2.0、服务账号
- 开始使用:设置 Address Validation API
- 参考文档:Address Validation API 参考文档
- 价格:Address Validation API 用量和结算
- 政策:Address Validation 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 的用途
请参阅下面链接的指南,了解每项任务,或在功能探索器中比较不同产品。
- 返回指定地址或部分地址的经过验证的地址。
- 返回经过验证的地址的纬度/经度坐标。
- 返回经过验证的地址的 Google 地点标识符。
- 使用美国邮政服务 (USPS) 编码精度支持系统 (CASS) 认证进行地址验证。
- 返回有关经过验证的地址是商家、住宅还是邮政信箱的信息。
- 返回已验证地址的美国邮政服务 (USPS) 递送元数据。
- 返回经过验证的地址的英文版本。预览
- 返回经过验证的地址的 Plus Code。