本月上线内容:地理编码、IP、时区等
API 近期工作汇总:新的兼容主机、更快的时区和海拔查询、控制台新功能,以及更清晰的配额可见性。
导航和物流软件往往在相当深的层面上内置了 TomTom Search,因为其中的位置查询通常与同一团队以同一风格构建的路线规划和地图调用放在一起。在不触动其余部分的情况下迁移其中一块,正是我们的兼容主机旨在实现的。
它完全复刻 TomTom Search 的请求参数和响应正文,唯一的区别是版权、条款和隐私文本,这些内容对应的是 My Geocode 而非原提供商。您的代码如今在哪里发送 TomTom 格式的地理编码请求,就可以把同样的请求发送到我们的主机,响应的解析方式相同,现有逻辑无需任何改动。
同一团队构建的路线规划和地图调用往往遵循共同的约定:相同的重试逻辑、相同的错误处理、对响应时间相同的预期。完全匹配 TomTom Search 的请求和响应结构,而不是提供一个类似但不同的地理编码 API,意味着周围的逻辑不必仅仅因为中间某个调用现在指向了别处就重新测试。
身份验证使用我们一贯的四种方式:X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证,或查询参数。您当前 TomTom 集成所依赖的任何一种方式在这里同样被接受,无需修改。
定价与平台上其他所有主机和端点完全相同。任何地址无需密钥即可获得每天 2,500 次免费请求,按网络统计。密钥还会额外提供自己的每天 2,500 次免费请求。超出这两项配额后,预付额度为每次请求 €0.0001,或者用每月 €50 的 Unlimited 套餐覆盖用量;使用兼容主机而非原生端点不会产生额外费用。
运行导航或物流软件的团队经常把流量分散到多个密钥上,每个环境一个,或每个内部服务一个,这样预发布环境中的问题就永远不会占用生产环境的配额。控制台中的密钥页面位于 /dashboard/keys,对于 TomTom 格式的集成,生成和命名额外密钥的方式与其他任何集成相同。
这个主机上的每个响应也都附带配额响应头:X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used 和 X-Credits-Remaining 全部包含在内,提供直接的 TomTom 集成本身不会呈现的用量洞察。
如果项目需要标准兼容响应之外的内容,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在其上叠加可选的额外字段,完全由您选择;除非您明确要求更多内容,否则基础响应结构保持不变。
该主机的文档位于 /compatibility/tomtom/,平台上兼容主机的通用迁移指南位于 /docs/compatibility/。把现有的 TomTom 格式集成重定向到这里,只需修改主机名并使用一个新密钥,别无其他。