迁移

从 TomTom Search 迁移

TomTom Search 大量出现在汽车、车队管理和导航软件中,这些行业对沿路线的地理编码精度与单纯的地址匹配同样看重。它的 API 密钥作为查询参数发送,地理编码响应以 results 数组返回,其中包含一个 position 对象和一个 address 块,内含 freeformAddressmunicipality 等字段。

这一领域的软件通常由并非草率选择 TomTom 的团队构建;做出这个决定时往往已经与其他方案做过评估,这意味着后来的迁移多半是出于成本、冗余规划或更大范围的供应商整合,而不是对数据本身不满。这一背景会影响迁移范围的划定:它很少是紧急的,通常有时间好好测试。

My Geocode 的 TomTom 兼容主机完全按照 TomTom 的返回方式复现 results 数组、position 对象和地址字段,唯一的区别是版权、条款和隐私文字。字段参考记录在 /compatibility/tomtom/。围绕 results[0].position.latresults[0].address.freeformAddress 构建的代码,在更换主机和密钥后应当继续正常工作。

特别是对于车队和汽车软件,在切换上线之前有几件事值得再次确认:

  • 所有按计划运行的批量地理编码任务,因为它们是测试新主机的理想首选目标,不会影响面向客户的实时调用
  • 针对 TomTom 特定响应时间调整过的重试和超时逻辑,因为这些值通常是凭经验设定而非有文档记录的,可能需要重新调整
  • 所有读取 TomTom 特有的置信度或匹配质量字段的代码,值得与兼容主机文档中的对应字段逐项对比

身份验证支持 X-API-Key 请求头、Authorization: Bearer 请求头、HTTP Basic 认证或查询参数,无论您现有的 TomTom 客户端目前以何种方式发送密钥,都能覆盖。

在成本方面,这种结构省去了通常的企业谈判环节:不需要密钥即可每天免费发出 2,500 次请求,每个密钥还各自增加每天 2,500 次免费请求,按网络计算。超出配额后,按每次请求 €0.0001 使用预付额度,或使用每月 €50 的 Unlimited 密钥,所有端点(包括这个兼容主机)价格完全相同。对于以可观用量运行地理编码的车队业务,采用统一费率而不是分档的企业协议,会让成本预测简单得多。

如果您对 TomTom 的使用除了地理编码之外还包括路线规划或交通数据,这部分技术栈不在仅限地理编码的迁移范围之内,可以继续留在 TomTom,而地址查询调用则独立迁移。像这样沿着清晰的功能边界拆分迁移,通常比试图在一次发布中迁移所有内容更能降低风险。