新闻

与 Geocodio 的兼容替换已上线

Geocodio 凭借简单直接的批量地理编码建立了口碑,相当多基于它构建的集成都高度依赖这种批量行为。我们的兼容主机完全匹配单次查询和批量请求两种结构,因此这种依赖不会成为切换的障碍。

该主机精确复刻 Geocodio 的请求参数和响应正文,唯一的区别是版权、条款和隐私文本,这些是 My Geocode 自己的内容。当前按 Geocodio 端点格式构建的请求,无论单次还是批量,都可以原样发送到我们的主机,响应的解析方式与现有代码原本期望的相同。

这里批量请求的计数方式与平台上其他任何地方相同:批量调用中的每个地址计为一次请求,而不是把整个调用计为一次。这样无论一次调用携带一个地址还是许多地址,配额统计都保持准确。

一次调用中提交的五百个地址,会按五百次请求计入配额;如果免费配额已经用完,也按五百次请求扣除预付额度,与五百次单独调用完全相同。正是这种粒度,让 X-Quota-UsedX-Credits-Remaining 在大批量任务完成的那一刻就保持准确,而不是等到几分钟后某个后台任务赶上进度才结算。

身份验证使用我们标准的四种方式:X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证,或查询参数,与您当前 Geocodio 集成已经使用的方式保持一致。

整个平台的定价都相同。任何地址无需密钥即可获得每天 2,500 次免费请求,按网络统计。密钥还会额外提供每天 2,500 次免费请求。超出之后,预付额度为每次请求 €0.0001,或者用每月 €50 的 Unlimited 套餐覆盖全部用量;单次查询和批量中的每一项都适用相同的费率。

控制台中的优惠券码是测试这类以批量为主的迁移的常用方式,可以先不投入真实预算:先给账户加上一笔额度,再决定是否通过预付额度或 Unlimited 套餐正式为其充值。

每个响应,无论批量还是单次,都附带配额响应头:X-Quota-LimitX-Quota-UsedX-Quota-Free-RemainingX-Quota-Network-UsedX-Credits-Remaining 准确反映一个批次消耗了多少项,这种精确度便于据此进行规划。

如果项目需要标准兼容响应之外的内容,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在其上叠加可选的额外字段;除非明确请求,否则不会改动基础结构。

该主机的文档位于 /compatibility/geocodio/,关于如何切换现有集成的通用指南位于 /docs/compatibility/。在真正依赖它处理大量请求之前,先对新主机测试一次批量调用,是确认配额计数完全符合预期的快速方法。