My Geocode

Migração

Migrando do Geocodio

· 2 min de leitura · My Geocode · #geocodio#migration#geocoding#bulk-geocoding#compatibility

O Geocodio construiu uma sólida reputação especificamente em torno da precisão de endereços dos Estados Unidos e do Canadá, junto com um fluxo de upload de CSV em lote que permite geocodificar uma planilha de endereços sem escrever nenhum código de integração. A chave de API dele é enviada como parâmetro de consulta (api_key), e as respostas para um único endereço vêm com um array results contendo address_components e um campo accuracy que descreve a confiança da correspondência.

Vale a pena tratar o fluxo de CSV em lote como um item de migração à parte, separado de quaisquer chamadas programáticas de API que a sua aplicação faz. Uma equipe de marketing ou um analista de operações que envia uma planilha por um formulário web uma vez por mês não é afetado por mudanças no seu código de backend, e esse fluxo precisa de um plano próprio, seja escrevendo um script de processamento em lote com a nova API, seja tratando-o manualmente durante um período de transição.

Para o lado programático, o host de compatibilidade com o Geocodio do My Geocode reproduz o array results e a estrutura address_components que o Geocodio retorna, sendo o texto de copyright, termos e privacidade o único conteúdo que muda. Os detalhes de referência estão em /compatibility/geocodio/. O código que lê results[0].address_components.city deve continuar funcionando depois que o host e a chave forem atualizados.

Alguns pontos que merecem planejamento especificamente por causa do foco regional do Geocodio:

  • Se a sua integração depende de algum campo adicional específico dos EUA, como informações de distrito eleitoral do Congresso, verifique se esse dado faz parte do escopo da sua migração ou se vai precisar de uma consulta separada daqui em diante
  • Confirme se algum processamento em lote roda com um limite de taxa ajustado especificamente aos limites documentados do Geocodio, já que um tempo de novas tentativas construído em torno dos números de um provedor não necessariamente se encaixa nos de outro
  • Teste um lote de endereços históricos reais dos seus próprios dados no novo host antes de supor paridade total, principalmente em casos extremos como caixas postais ou endereços de rotas rurais

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, então qualquer que seja o estilo que o seu cliente atual do Geocodio usa para o parâmetro api_key, há um equivalente aqui.

Quanto ao custo, não há um nível de preço separado para processamento em lote: todos os endpoints, incluindo este host de compatibilidade, têm o mesmo preço, com 2.500 requisições gratuitas por dia sem precisar de nenhuma 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. Um grande processamento em lote único e um fluxo constante de chamadas de API custam o mesmo por requisição, o que torna a estimativa do custo de uma migração em lote uma simples multiplicação, e não uma consulta a uma tabela de níveis.

Mais em Migração