迁移

从 Geocodio 迁移

Geocodio 专门在美国和加拿大地址准确性方面建立了良好的声誉,它还提供批量 CSV 上传工作流,让人无需编写任何集成代码就能对一整张地址表格进行地理编码。它的 API 密钥以查询参数(api_key)的形式发送,单个地址的响应返回一个 results 数组,其中包含 address_components 和一个描述匹配置信度的 accuracy 字段。

批量 CSV 工作流值得作为单独的迁移事项来处理,与您的应用发出的任何程序化 API 调用分开。每月通过网页表单上传一次表格的营销团队或运营分析师,不会受到您后端代码更改的影响,这个工作流需要自己的计划,无论是编写针对新 API 的批处理任务脚本,还是在过渡期间手动处理。

在程序化调用方面,My Geocode 的 Geocodio 兼容主机重现了 Geocodio 返回的 results 数组和 address_components 结构,唯一变化的内容是版权、条款和隐私文本。参考详情见 /compatibility/geocodio/。读取 results[0].address_components.city 的代码在更新主机和密钥后应能继续工作。

由于 Geocodio 专注于特定区域,有几点值得专门规划:

  • 如果您的集成依赖任何美国特有的附加字段,例如国会选区信息,请确认该数据点是否在您的迁移范围之内,还是今后需要单独查询
  • 确认是否有任何批量任务按照专门针对 Geocodio 文档所述限制调整的速率限制运行,因为围绕某个提供商的数字构建的重试时机,并不一定适合另一个提供商
  • 在认定完全一致之前,先用您自己数据中的一批真实历史地址对新主机进行测试,尤其是邮政信箱或农村线路地址等边缘情况

认证支持 X-API-Key 请求头、Authorization: Bearer 请求头、HTTP Basic 认证或查询参数,因此无论您现有的 Geocodio 客户端以哪种方式传递 api_key 参数,这里都有对应的方式。

在费用方面,无需考虑单独的批量价格档位:每个端点(包括这个兼容主机)的价格都相同,完全不用密钥即可每天免费请求 2,500 次,每个密钥每天另外免费 2,500 次,按网络计算,超出之后是每次请求 €0.0001 的预付额度或每月 €50 的 Unlimited 密钥。无论是一次性的大型批量任务,还是持续少量的 API 调用,每次请求的费用都一样,因此估算批量迁移的费用只需简单的乘法,而不必查询价格档位。