Migração

Migrando do Geocode.Farm

O Geocode.Farm é um nome menor na geocodificação, escolhido com frequência por equipes que procuram uma opção simples e sem complicações, em vez de uma grande plataforma corporativa. A chave de API dele autentica requisições enviadas como parâmetros de consulta, e as respostas JSON incluem um objeto geometry com as coordenadas da localização e um campo accuracy que indica a confiança da correspondência, dentro de uma estrutura que mantém a resposta razoavelmente plana em comparação com alguns dos provedores maiores.

Um provedor menor traz um tipo específico de motivação para migrar que vale a pena nomear diretamente: às vezes as equipes deixam um fornecedor menor não porque algo deu errado, mas porque querem a segurança de uma plataforma com mais opções de compatibilidade e um roteiro de longo prazo mais claro, especialmente quando um projeto que começou pequeno passa a lidar com bem mais tráfego ou com fluxos mais críticos para o negócio.

O host de compatibilidade com o Geocode.Farm do My Geocode reproduz a estrutura dos campos geometry e accuracy que o Geocode.Farm retorna, sendo o texto de copyright, termos e privacidade a única parte da resposta que muda. A referência dos campos está em /compatibility/geocode-farm/. O código de aplicação construído em torno desse formato de resposta deve precisar apenas de uma troca de host e de chave para continuar funcionando.

Algumas coisas que vale verificar especificamente nesta migração:

  • Se a sua integração trata erros de limite de taxa com uma lógica ajustada às respostas específicas do Geocode.Farm, já que os formatos de erro variam entre provedores e estão documentados para esta plataforma em /docs/errors/
  • Se a sua chave está atualmente embutida diretamente no código da aplicação em vez de na configuração, algo que vale corrigir durante esta mudança, qualquer que seja o destino
  • Se você também usa o Geocode.Farm para geocodificação reversa, já que esse padrão de requisição é diferente do da geocodificação direta e merece sua própria rodada de testes

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 o que o seu cliente atual do Geocode.Farm já faz.

Quanto aos preços, passar de um provedor menor e mais especializado para uma plataforma mais ampla não significa uma estrutura de custos mais complicada aqui. São 2.500 requisições gratuitas por dia sem precisar de chave, mais 2.500 gratuitas por chave por dia contadas por rede e, acima disso, 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 de compatibilidade, pelo mesmo preço. Como o My Geocode oferece 17 hosts de compatibilidade no total, uma equipe que migra de um provedor menor também ganha a opção de testar mais tarde os formatos de resposta de outros provedores lado a lado, sem abrir uma segunda conta em outro lugar para isso.