Google 表格中的地址验证 API

目标

在本文档中,我们将介绍如何在 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 密钥):

  1. 前往示例 电子表格 ,然后在菜单中依次选择:文件 > 制作副本
    (您需要登录Google 账号 或创建一个账号)
  2. 启用 Address Validation API ,并从 Cloud Console 生成 API 密钥。
  3. 在“API 密钥 + 信息中心”表格标签页中,将 B2 单元格替换为您的 API 密钥。
  4. 在模板中复制/粘贴地址(在单独的工作表中格式化数据:连接门牌号、名称、城市、邮政编码)
  5. 选择表格单元格,然后从菜单中依次选择“地址验证”>“Address Validation API 选择”
  6. 首次执行时,系统会显示“需要授权”消息,以提供对 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 | 解决方案工程师