迁移

从 Geocode.Farm 迁移

Geocode.Farm 在地理编码领域知名度较小,常被寻找简单直接、没有多余功能的选项、而不是大型企业平台的团队选用。它的 API 密钥用于认证以查询参数形式发送的请求,其 JSON 响应包含一个带有位置坐标的 geometry 对象和一个表示匹配置信度的 accuracy 字段,外层结构与一些大型提供商相比保持得相当扁平。

小型提供商带来了一种值得直接点明的特殊迁移动机:团队有时离开小型供应商,并不是因为出了什么问题,而是希望获得一个拥有更多兼容选项和更清晰长期路线图的平台所带来的保障,尤其是当一个起步很小的项目开始处理明显更多的流量或更关键的业务工作流时。

My Geocode 的 Geocode.Farm 兼容主机重现了 Geocode.Farm 返回的 geometry 和 accuracy 字段结构,响应中唯一变化的部分是版权、条款和隐私文本。字段参考见 /compatibility/geocode-farm/。围绕这种响应结构构建的应用代码,应该只需更改主机和密钥即可继续运行。

此次迁移中特别值得检查的几件事:

  • 您的集成是否使用针对 Geocode.Farm 特定响应调整过的逻辑来处理速率限制错误,因为不同提供商的错误结构各不相同,本平台的错误结构记录在 /docs/errors/
  • 您的密钥目前是否直接嵌入在应用代码中而不是配置中,无论迁移目标是什么,都值得在这次迁移中修正
  • 您是否也使用 Geocode.Farm 进行逆地理编码,因为该请求模式与正向地理编码不同,值得单独进行一轮测试

认证接受 X-API-Key 请求头、Authorization: Bearer 请求头、HTTP Basic 认证或查询参数,涵盖您现有的 Geocode.Farm 客户端已在使用的任何方式。

在价格方面,从一个较小、更专门化的提供商迁移到一个更全面的平台,在这里并不意味着更复杂的费用结构。无需密钥即可每天免费请求 2,500 次,每个密钥每天另外免费 2,500 次,按网络计算,超出之后是每次请求 €0.0001 的预付额度或每月 €50 的 Unlimited 密钥,每个端点(包括这个兼容主机)的价格都相同。鉴于 My Geocode 总共提供 17 个兼容主机,从小型提供商迁出的团队以后还可以并排测试其他提供商的响应结构,而无需为此在别处另开一个账户。