O que lançamos este mês: geocodificação, IP, fuso horário e mais
Um resumo do trabalho recente em toda a API: novos hosts de compatibilidade, consultas de fuso horário e altitude mais rápidas, recursos no painel e mais visibilidade sobre a cota.
Compatibilidade drop-in com o TomTom Search já está no ar
Softwares de navegação e logística muitas vezes têm o TomTom Search embutido em um nível bastante profundo, já que as consultas de localização costumam ficar ao lado de chamadas de roteamento e de mapas feitas pela mesma equipe, no mesmo estilo. Mover uma peça sem mexer no resto é exatamente o que nosso host compatível foi projetado para tornar possível.
Ele reproduz exatamente os parâmetros de requisição e o corpo de resposta do TomTom Search, e a única diferença são os textos de direitos autorais, termos e privacidade, que refletem o My Geocode em vez do provedor original. Onde quer que seu código envie hoje uma requisição de geocodificação no formato do TomTom, ele pode enviar essa mesma requisição ao nosso host, e a resposta é interpretada da mesma forma, sem nenhuma mudança na sua lógica atual.
Chamadas de roteamento e de mapas feitas pela mesma equipe costumam compartilhar convenções: a mesma lógica de novas tentativas, o mesmo tratamento de erros, as mesmas expectativas de tempo. Reproduzir exatamente o formato de requisição e resposta do TomTom Search, em vez de oferecer uma API de geocodificação parecida, mas diferente, significa que essa lógica ao redor não precisa ser testada de novo só porque uma chamada no meio agora aponta para outro lugar.
A autenticação usa nossas quatro opções habituais: cabeçalho X-API-Key, cabeçalho Authorization: Bearer, HTTP Basic auth com a chave como nome de usuário ou parâmetro de consulta. Seja qual for a forma em que sua integração atual com o TomTom já se baseia, ela também é aceita aqui, sem modificação.
Os preços são idênticos aos de todos os outros hosts e endpoints da plataforma. Qualquer endereço recebe 2.500 requisições gratuitas por dia sem precisar de chave, contadas por rede. Uma chave adiciona mais 2.500 requisições gratuitas por dia próprias. Além das duas cotas, o crédito pré-pago custa € 0,0001 por requisição, ou um pacote Unlimited cobre o uso por € 50 por mês, sem cobrança extra por usar um host compatível em vez de um nativo.
Equipes que operam softwares de navegação ou logística muitas vezes dividem o tráfego entre mais de uma chave, uma por ambiente ou uma por serviço interno, para que um problema em staging nunca consuma a cota de produção. A página de chaves no painel, em /dashboard/keys, permite gerar e nomear chaves adicionais da mesma forma para uma integração no formato do TomTom e para qualquer outra.
Os cabeçalhos de cota vêm em todas as respostas deste host também: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used e X-Credits-Remaining estão todos presentes, oferecendo um nível de percepção do uso que uma integração direta com o TomTom não exporia.
Se um projeto quiser mais do que a resposta compatível padrão, adicionar mg_extras=1 à requisição, ou enviar um cabeçalho X-MG-Extras, acrescenta campos extras opcionais por cima, apenas se você escolher, deixando o formato base da resposta intocado a menos que você peça especificamente mais.
O host está documentado em /compatibility/tomtom/, e as orientações gerais de migração para os hosts compatíveis de toda a plataforma estão em /docs/compatibility/. Redirecionar para cá uma integração existente no formato do TomTom exige um nome de host alterado e uma chave nova, nada mais.