NEWS

---

geocodebr 0.6.3 (2026-05-24)

Correção de bugs (Bug fixes)

• Bug corrigido que agora permite usuários passarem como input tabelas de endereços com apenas alguns campos. Os campos de municio e unidade da federação continuam sendo obrigatórios. Encerra #89 e #94

Mudanças pequenas (Minor changes)

• A função geocode_reverso() teve pequeno ganho de velocidade, com drástica redução no consumo de memória. Na amostra de 1000 pontos, o uso de memória caiu de 161MB para 95MB.

geocodebr 0.6.2 (2026-04-14)

Correção de bugs (Bug fixes)

• Bug corrigido para garantir que o pacote utiliza apenas os dados em cache do data release corrente, e ignora eventuais dados de releases antigos que estejam na pasta. Encerra #90
• A função geocode() agora retorna erro informativo quando alguma coluna na tabela de input tem nome com algum caractere não alfanumérico, como . , ? ^ - ! ~. Não há problema com o barra baixa _, como em “name_muni”. Fecha issue #92
• Corrigido erro na função de geocode_reverso() que impedia usar valores muito altos de dist_max. Encerra #88
• Incluido 'Language: pt' na DESCRIPTION

geocodebr 0.6.1 (2026-01-27)

Correção de bugs (Bug fixes)

• Essa versão corrige um erro que havia nas coordenadas co CNEFE utilizadas na v0.6.0.

geocodebr 0.6.0 (2026-01-23)

Mudanças grandes (Major changes)

• A função geocode() agora retorna o codigo do setor censitário do endereço encontrado quando resultado_completo = TRUE. Essa alteração atende parcialmente ao issue #66 porque ela somente retorna o código do setor dos casos em que o endeço encontrado está 100% dentro de um único setor censitário. Quanto os dados do CNEFE correspondentes ao endereço buscado estão em mais de um setor, o resultado da coluna cod_setor é NA.
• Dependência do pacote agora usa enderecobr (>= 0.5.0), que foi reescrito em Rust. Isso traz grandes ganhos de performance para processamento de bases acima de 10 milhões
• Nova atualização da da base de referência (CNEFE padronizado v0.4.0)

Outras novidades (Other news)

• Novo co-autor do pacote: Gabriel Garcia de Almeida

geocodebr 0.5.0 (2025-12-09)

Mudanças grandes (Major changes)

• Novas versões da funções geocode(), geocode_reverso() e busca_por_cep() são significamente mais rápidas e usam menos memória RAM. O ganho de eficiência é relativamente maior em consultas pequenas. Ver ganhos de performance no issues encerrados: #82, #81 e #83
• Por padrão, as funções agora recebem n_cores = NULL, e o pacote utiliza o número máximo de cores físicos disponíveis.
• Agora o argumento resolver_empates passa a ser TRUE como padrão.

Mudanças pequenas (Minor changes)

• As tabelas do cnefe agora são registradas na db uma única vez. Encerra issue #79.
• O output da função geocode() agora é apenas um "data.frame", e não mais um "data.table" "data.frame".
• A função geocode() passa a ter um novo argumento padronizar_enderecos que indica se os dados de endereço de entrada devem ser padronizados. Por padrão, é TRUE. Essa padronização é essencial para uma geolocalizaçao correta. Alerta! Apenas utilize padronizar_enderecos = FALSE caso os dados de input já tenham sido padronizados anteriormente com enderecobr::padronizar_enderecos(..., formato_estados = 'sigla', formato_numeros = 'integer'). Encerra issue #68.
• Incluído o apoio do Instituto Todos pela Saúde (ITpS) no README e no arquivo DESCRIPTION. Encerra issue #71.

Correção de bugs (Bug fixes)

• A função geocode() agora é envolta com {callr}, e por isso usa muito menos memória RAM e não tem vazamento de memória. #48

geocodebr 0.4.0 (2025-11-18)

Mudanças grandes (Major changes)

• A função geocode() agora não aplica match probabilístico em lograouros cujo nome são só uma letra (e.g. RUA A, RUA B, RUA C) ou compostos só por dígitos (RUA 1, RUA 10, RUA 20). Encerra issue #67. Isso diminui muito os casos de falso positivo no match probabilístico.
• O parâmetro h3_res utilizado nas funções geocode() e busca_por_cep() agora aceita um vetor de números indicando diferentes resoluções de H3. Encerra issue #72.

Mudanças pequenas (Minor changes)

• Definição de número de n_cores para paralelização mais segura usando {parallelly}.
• Ganhos de performance em algumas funções de match (issues #73, #74 e #75).
• Tratamento de casos de empate agora é feito interamente dentro do DuckDB. Encerra issue #57
• O geocodebr não depende mais do pacote Rcpp, que antes era utilizado para calcular distâncias entre coordendas. Esses cálculo agora é feito inteiramente dentro do DuckDB.

Novos contribuidores (New contributions)

• Pedro Milreu Cunha

geocodebr 0.3.0 (2025-10-08)

Mudanças grandes (Major changes)

• Novo parâmetro h3_res nas funções geocode() e busca_por_cep(), que permite o usuário inserir uma coluna no output indicando o id da célula H3 na resolução espacial desejada. Encerra issue #43.
• O output da função geocode() agora inclui uma nova coluna desvio_metros que apresenta de forma intuitiva o grau de incerteza do resultado encontrado. Encerra issue #11.
• Nova base de dados (release v0.3.0). A principal mudança aqui foi a estratégia de agregação de coordenadas. Na versão anterior, a base consistia numa média simples das coordenadas dos pontos que pertenciam ao mesmo grupo de colunas. Na atual versão, esse cálculo é feito em duas etapas. Primeiro encontramos o ponto médio e calculamos sua distância até todos os pontos. Em seguida, descartamos aqueles pontos que estão acima do percentil 95% de distância, e recalculamos então novo ponto médio. Isso evita eventuais distorções quando há poucos pontos muito isolados.
• A nova base de dados (release v0.3.0) utiliza arquivos em formato .parquet compactados, o que diminuiu pela metade o tamanho dos arquivos (de 2.98 GB para 1.17 GB) e acelera o processo de download dos dados (embora deixa o processamento em si ligeiramente mais devagar).
• Os dados de cache agora são armazenados na sub-pasta "geocodebr_data_release_{data_release}", dentro da pasta de cache definida pelo usuário. De agora em diante, os dados de releases antigos passam a ser deletados automaticamente quando há atualização do data release. Encerra issue #64. Mas os dados das versões anteriores v0.2.0 devem ser apagados manualmente com a função deletar_pasta_cache().

geocodebr 0.2.1 (2025-07-07)

Correção de bugs (Bug fixes)

• Resolvido bug que retornava erro se o input to usuario comecava o geocode direto a partir do match case "pl01". Encerra issue #56.

geocodebr 0.2.0 (2025-05-07)

Mudanças grandes (Major changes)

• A função geocode() agora inclui busca com match probabilistico. Encerra issue #34.
• Nova função buscapor_cep(). Encerra issue #8.
• Nova função geocode_reverso(). Encerra issue #35.
• A função download_cnefe() agora aceita o argumento tabela para baixar tabelas específicas.

Mudanças pequenas (Minor changes)

• Ajuste na solução de casos de empate mais refinada e agora detalhada na documentação da função geocode(). Encerra issue #37. O método adotado na solução de empates agora fica transparente na documentação da função geocode().
• Nova vignette sobre a função geocode_reverso()
• Vignette sobre Get Started e da função geocode() reorganizadas

Correção de bugs (Bug fixes)

• Resolvido bug que decaracterizava colunas de classe integer64 na tabela de input de endereços. Encerra issue #40.

Novos contribuidores (New contributions)

• Arthur Bazzolli

geocodebr 0.1.1 (2025-02-17)

Correção de bugs

• Corrigido bug na organização de pastas do cache de dados. Fecha o issue 29.

geocodebr 0.1.0 (2025-02-12)

• Primeira versão.