Passo a passo

Todos os controles de configuração ficam no menu à esquerda.

1. Escolha o método de processamento.
   Match probabilístico usa a base CNEFE local; GeocodeBr usa o pacote geocodebr. Para o Distrito Federal, o match probabilístico aciona automaticamente o pipeline determinístico de 18 fases.
2. Carregue o arquivo da base de notificações.
   Formatos aceitos: CSV, TXT, XLSX e XLS, com até 500 MB.
3. Informe o formato do arquivo.
   Em Arquivo SINAN, as colunas são padronizadas automaticamente. Em Declarar colunas de endereço, indique quais colunas do seu arquivo correspondem a código único, logradouro, número, município, bairro, RA e complemento — útil para bases que não seguem o layout do SINAN.
4. Selecione a UF.
   Define qual tabela do CNEFE será consultada e qual pipeline será executado. Em arquivos no formato SINAN, a UF também é detectada automaticamente a partir da coluna SG_UF.
5. Defina o escopo do processamento.
   A UF inteira, ou um município específico pelo código IBGE de 6 dígitos.
6. Ajuste o limite de similaridade.
   Valor mínimo de similaridade para que um match probabilístico seja aceito nas fases 4 e 5. Valores mais altos são mais conservadores: menos casos georreferenciados, com maior confiança em cada um. Não afeta o pipeline do Distrito Federal, que é determinístico.
7. Clique em Processar Dados.
   O andamento aparece em uma barra de progresso com a fase em execução. Ao terminar, o painel abre automaticamente a aba Resumo.

Depois do processamento, as demais abas ficam disponíveis:

• Resumo — método utilizado, escopo processado, tempo de execução e total de registros, com os botões de download.
• Métricas Detalhadas — distribuição de casos por município ou RA; cobertura e matches por fase no DF; qualidade, tipo de endereço e estatísticas de similaridade nas demais UFs.
• Gráficos — distribuição de similaridade dos casos processados.
• Mapa de Coordenadas — visualização interativa dos casos georreferenciados, como pontos ou densidade de kernel (KDE).
• Triagem de Endereços — revisão manual, caso a caso, dos registros de baixa similaridade, escolhendo entre os candidatos rankeados. Indisponível para o DF, cujo pipeline é determinístico e não gera candidatos alternativos.

Metodologia

O georreferenciamento funciona como uma cascata de tentativas: as fases são aplicadas em sequência, da mais determinística e confiável para a mais aproximada. Um caso só é avaliado por uma fase se não obteve match em nenhuma das fases anteriores — e o rótulo da fase que o resolveu fica gravado no resultado, permitindo auditar a confiabilidade de cada registro individualmente.

O método aplicado depende da Unidade Federativa selecionada:

O critério exato de cada fase, o rótulo gravado no resultado e a referência à linha correspondente no código estão descritos na Documentação das Fases de Matching.

Fontes de dados

Referências

• CNEFE — Cadastro Nacional de Endereços para Fins Estatísticos (IBGE) Página oficial da base de endereços usada como referência na geocodificação.
• Tuberculose — Cenários de Risco e Determinantes Sociais Eixo do Programa Cenários do qual este painel é uma entrega.
• Repositório do sistema no GitHub Código-fonte, instruções de instalação e documentação técnica.
• Documentação das Fases de Matching Critério de match, rótulo gravado e referência no código, fase a fase.