My Geocode

Migração

Migrando do LocationIQ

· 2 min de leitura · My Geocode · #locationiq#migration#geocoding#open-data#compatibility

O LocationIQ se posiciona em torno de dados geográficos abertos e de um modelo simples de autenticação por chave, enviada como parâmetro de consulta, com respostas JSON que trazem lat, lon, display_name e um objeto address dividido em campos familiares para quem também já usou diretamente dados derivados do OpenStreetMap. Essa familiaridade não é por acaso: provedores construídos sobre fontes de dados abertas tendem a convergir para nomes de campos parecidos, o que vale a pena saber se você está comparando vários ao mesmo tempo.

As equipes que escolheram o LocationIQ muitas vezes o fizeram pela combinação de um ponto de entrada generoso com uma integração direta, sem precisar negociar antes um contrato corporativo. O ideal é que uma migração preserve essa experiência em vez de trocá-la por um processo de onboarding mais pesado.

O host compatível com LocationIQ do My Geocode reproduz exatamente os campos lat, lon, display_name e os componentes do endereço, e apenas os textos de copyright, termos e privacidade diferem do original. Os detalhes de referência estão em /compatibility/locationiq/. O código da aplicação que lê response.display_name ou percorre os campos de response.address não deve precisar de mudanças além do nome do host e da chave.

Um checklist curto para esta migração em particular:

  • Confirme qual método de autenticação a sua biblioteca cliente usa hoje (o LocationIQ normalmente aceita um parâmetro de consulta) e compare com os quatro estilos suportados aqui: cabeçalho X-API-Key, Authorization: Bearer, autenticação HTTP Basic ou um parâmetro de consulta
  • Verifique se a sua integração também chama um endpoint de geocodificação reversa, já que o formato da requisição ali difere da geocodificação direta e vale a pena testá-lo separadamente
  • Revise qualquer código de tratamento de limite de taxa que você tenha escrito especificamente para os cabeçalhos de resposta do LocationIQ, já que os nomes dos cabeçalhos variam entre provedores e a sua lógica de novas tentativas pode referenciá-los pelo nome

No lado dos preços, a comparação é bem direta: nenhuma chave é necessária para 2.500 requisições por dia, e mais 2.500 gratuitas por chave por dia, contadas por rede, seja IPv4 (por /24) ou IPv6 (por /48). Passada a cota gratuita, vale o crédito pré-pago a € 0,0001 por requisição ou uma chave Unlimited a € 50 por mês, e todos os endpoints custam o mesmo, sem uma faixa separada para volume de geocodificação em comparação com outras consultas.

Se o seu uso do LocationIQ cresceu naturalmente de um projeto paralelo para algo de que as pessoas dependem, um host compatível existe justamente para tornar esse tipo de migração tediosa no melhor sentido: troque o nome do host, troque a chave e continue entregando. O código de parsing que deu trabalho para acertar da primeira vez não precisa de uma segunda rodada só porque o provedor por trás dele mudou. A visibilidade completa da cota, incluindo o uso por rede, vem pelos cabeçalhos de resposta padrão documentados em /docs/rate-limits/.

Mais em Migração