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. 首次执行时,系统会显示“需要授权”消息,以提供对 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 | 解决方案工程师\