目标
在本文档中,我们将介绍如何在 Google 表格 中使用 Address Validation API,以便快速轻松地测试该服务。
作为非开发者,您可能希望在不借助技术团队过多帮助的情况下,开始使用来自 Google Maps Platform(例如 Address Validation API)的数据。

使用场景
现在,让我们了解在哪些使用场景中,Google 表格中的 Address Validation API 非常有用:
- 试用:作为商家,您可能希望使用自己的地址快速测试 Address Validation API 的功能。
- 比较:将 Address Validation API 结果与其他端点 结果(例如 Geocoding API 或 Places API)进行比较。
- A/B 测试:对同一数据集的变体进行 A/B 测试,以了解哪种变体
可能会提供更合适的结果。
Google 表格模板
该解决方案是一个 Google 表格,其中 包含自定义 Apps 脚本 函数,这些函数将按顺序向 Address Validation API 发出请求。
您可以按照以下步骤通过 API 运行地址(需要 Google
账号 和 API
密钥):
- 前往示例
电子表格
,然后在菜单中依次选择:文件 > 制作副本
(您需要登录Google 账号 或创建一个账号) - 启用 Address Validation
API
,并从 Cloud
Console 生成 API 密钥。
- 在“API 密钥 + 信息中心”表格标签页中,将 B2 单元格替换为您的 API 密钥。
- 在模板中复制/粘贴地址(在单独的工作表中格式化数据:连接门牌号、名称、城市、邮政编码)
- 选择表格单元格,然后从菜单中依次选择“地址验证”>“Address Validation API 选择”
- 首次执行时,系统会显示“需要授权”消息,以提供对 Apps 脚本的访问权限。
Google Maps Platform 条款
该解决方案仅用于测试目的,且仅适用于有限的一组地址:允许的缓存期限为 30 个连续日历日,之后客户必须 (1) 删除缓存的 Google 地图内容,或 (2) 替换为通过最终用户确认或更正提供的最终用户数据。请参阅 Google Maps
Platform 服务条款表 11.3.1(缓存
权限):
- placeId
- 位置:纬度值、经度值
- 判定
- formattedAddress
- postalAddress
- addressComponent:componentName
- USPS 数据 standardizedAddress
注意事项
- 性能:一次处理不超过 1000 行。脚本最终可能会停止,例如,当每秒超出 API 配额时,从脚本停止的行开始继续处理。
- 您可以依次选择“菜单”>“扩展程序”>“Apps 脚本”来访问代码,并根据自己的需求创建自己的脚本 版本
- Address Validation API 的价格 。
总结
借助 Google 表格中的 Address Validation API,非开发者可以开始查询 Address Validation API,并了解该 API 如何对他们的业务具有战略意义。本文档旨在演示任何人都可以通过创建 API 密钥和使用提供的 Google 表格模板来开始查询 API。
后续操作
建议进一步阅读:
贡献者
Google 负责维护本文。以下贡献者最初撰写了本文。
主要作者:
Thomas Anglaret | 解决方案工程师