目标
在本文档中,我们将介绍如何在 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 控制台生成 API 密钥。
- 在“API 密钥 + 信息中心”表格标签页中,将 B2 单元格替换为您的 API 密钥。
- 将地址复制/粘贴到模板中(在单独的电子表格中设置数据格式:串联门牌号、名称、城市、邮政编码)
- 选择工作表单元格,然后从菜单中依次选择“Address Validation” >“Address Validation API selection”
- 首次执行时,系统会显示“需要授权”消息,以提供对 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 | 解决方案工程师\