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 表格模板

解决方案是带有自定义 Apps 脚本函数的 Google 表格,可按顺序执行向 Address Validation API 发送请求。

您可以按照以下步骤通过 API 运行地址(需要 Google 帐号API 密钥):

  1. 转到示例电子表格,然后从菜单中选择:文件 > 制作副本
    (您需要登录您的 Google 账号或创建一个账号)
  2. 启用 Address Validation API 并从 Cloud 控制台生成 API 密钥。
  3. 在“API 密钥 + 信息中心”表格标签页中,将 B2 单元格替换为您的 API 密钥。
  4. 在模板中复制/粘贴地址(在单独的工作表中设置数据格式:串联门牌号、名称、城市、邮政编码)
  5. 选择工作表单元格,然后从菜单“地址验证” >“地址验证 API 选择”中进行选择
  6. 首次执行时,系统会显示“需要授权”消息,提供对 Apps 脚本的访问权限。



Google 地图平台条款

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

  • placeId
  • 位置:纬度值,经度值
  • 判定
  • formattedAddress
  • postalAddress
  • addressComponent:componentName
  • USPS Data standardizedAddress

注意事项

  • 性能:以 1000 行为单位的数据块,一次不重复。脚本最终可能会停止(例如当超过每秒 API 配额时),从脚本已停止的行继续。
  • 您可以通过“菜单”>“扩展程序”>“Apps 脚本”访问该代码,然后根据您的需求量身定制脚本版本
  • Address Validation API 的价格

总结

借助 Google 表格中的 Address Validation API,非开发者用户可以开始查询 Address Validation API,了解它如何对其业务具有战略意义。本文档将尝试演示用户如何通过创建 API 密钥和使用提供的 Google 表格模板来开始查询该 API。

后续操作

建议的深入阅读:


贡献者

本文由 Google 维护。该博文最初由以下贡献者编写。
首席作者:

Thomas Anglaret | 解决方案工程师\