O TomTom Search aparece muito em software automotivo, de gestão de frotas e de navegação, setores em que a precisão da geocodificação ao longo de uma rota importa tanto quanto a simples correspondência de endereços. A chave de API é enviada como parâmetro de consulta, e as respostas de geocodificação voltam como um array results com um objeto position e um bloco address com campos como freeformAddress e municipality.
O software desse setor costuma ser construído por equipes que não escolheram o TomTom à toa: a decisão normalmente já veio acompanhada de uma avaliação de alternativas, o que significa que uma migração posterior tende a ser motivada por custo, planejamento de redundância ou um esforço mais amplo de consolidação de fornecedores, e não por insatisfação com os dados em si. Esse contexto importa para definir o escopo de uma migração: raramente é urgente, e geralmente há tempo para testar direito.
O host compatível com TomTom do My Geocode reproduz o array results, o objeto position e os campos de endereço exatamente como o TomTom os retorna, e os textos de copyright, termos e privacidade são a única diferença. A referência de campos está documentada em /compatibility/tomtom/. O código construído em torno de results[0].position.lat e results[0].address.freeformAddress deve continuar funcionando depois que o host e a chave mudarem.
Especificamente para software de frotas e automotivo, vale conferir algumas coisas antes de a troca entrar em produção:
Quaisquer tarefas de geocodificação em lote executadas de forma agendada, já que são um bom primeiro alvo para testar um novo host sem mexer nas chamadas em tempo real voltadas aos clientes
A lógica de novas tentativas e de timeout ajustada ao tempo de resposta específico do TomTom, já que esses valores costumam ser definidos empiricamente em vez de documentados e podem precisar de novo ajuste
Qualquer código que leia campos de confiança ou de qualidade de correspondência específicos do TomTom, que vale comparar lado a lado com os equivalentes documentados do host compatível
A autenticação aceita um cabeçalho X-API-Key, um cabeçalho Authorization: Bearer, autenticação HTTP Basic ou um parâmetro de consulta, cobrindo qualquer forma que o seu cliente TomTom atual use hoje para enviar a chave.
Quanto ao custo, a estrutura elimina a etapa habitual de negociação corporativa: 2.500 requisições por dia são gratuitas sem necessidade de chave, e cada chave acrescenta as próprias 2.500 requisições gratuitas por dia, contadas por rede. Passada essa cota, vale o crédito pré-pago a € 0,0001 por requisição ou uma chave Unlimited a € 50 por mês, com todos os endpoints, incluindo este host compatível, com preço idêntico. Para uma operação de frotas que executa geocodificação em volume significativo, ter um preço único em vez de um contrato corporativo por faixas torna a previsão de custos consideravelmente mais simples.
Se o seu uso do TomTom também inclui roteamento ou dados de trânsito além da geocodificação, essa parte da stack fica fora do escopo de uma migração só de geocodificação e pode continuar no TomTom enquanto as chamadas de consulta de endereços migram de forma independente. Dividir uma migração ao longo de fronteiras claras de funcionalidade como essa tende a reduzir mais o risco do que tentar mover tudo em uma única versão.
Automações no-code construídas sobre uma etapa de geocodificação exigem uma abordagem de migração diferente da usada em código próprio. Veja como lidar com essa troca.
Trocar de fornecedor de dados de localização não é apenas uma decisão técnica. Veja o que revisar do lado do processamento de dados e da privacidade nessa mudança.
Desligar a chave de API de um provedor antigo cedo demais ou tarde demais traz riscos nos dois casos. Veja como aposentar credenciais corretamente quando uma migração estiver concluída.