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 控制台生成 API 密钥。
  3. 在“API 密钥 + 信息中心”表格标签页中,将 B2 单元格替换为您的 API 密钥。
  4. 将地址复制/粘贴到模板中(在单独的电子表格中设置数据格式:串联门牌号、名称、城市、邮政编码)
  5. 选择工作表单元格,然后从菜单中依次选择“Address Validation” >“Address Validation API selection”
  6. 首次执行时,系统会显示“需要授权”消息,以便您提供对 Google Apps 脚本的访问权限。



Google Maps Platform 条款

解决方案仅供测试用途,且仅适用于一组有限的地址:允许的缓存期限:连续 30 个日历日,在此期限过后,客户必须 (1) 删除缓存的 Google 地图内容,或 (2) 将其替换为通过最终用户确认或更正提供的最终用户数据。请参阅 Google Maps Platform 服务条款表 11.3.1(缓存权限)

  • placeId
  • 位置:纬度值、经度值
  • verdict
  • formattedAddress
  • postalAddress
  • addressComponent: componentName
  • USPS 数据 standardizedAddress

注意事项

  • 性能:一次处理不超过 1,000 行的分块。脚本最终可能会停止,例如,当超出每秒 API 配额时,脚本会从停止行继续。
  • 您可以依次点击“菜单”>“扩展程序”>“Apps 脚本”,然后根据自己的需求制作自己的脚本版本
  • Address Validation API 的价格

总结

借助 Google 表格中的 Address Validation API,非开发者可以开始查询 Address Validation API,并了解该 API 如何为其业务发挥战略作用。本文档旨在演示任何人都可以通过创建 API 密钥并使用提供的 Google 表格模板来开始查询该 API。

后续操作

建议的进一步阅读材料:


贡献者

本文由 Google 维护。以下贡献者最初撰写了这篇文章。
主要作者:

Thomas Anglaret | 解决方案工程师\