Como montar um mapa ou planilha com os resultados

Quais arquivos usar para o mapa ou a planilha?

Os arquivos em JSON são os mesmos que alimentam o mapa da Apuração 2026. Cada um traz um recorte da eleição: o total atual do país, dos estados e do exterior, a tabela de municípios de um estado ou as zonas eleitorais de uma cidade. Antes de baixar qualquer coisa, defina a unidade da sua análise, porque ela escolhe o arquivo.

Para um mapa do Brasil com um valor por estado, o ponto de partida é o arquivo de totais atuais, feed/agora.json, que traz presidente por Brasil, estado e exterior, além de governador e Senado por estado. Para um mapa por município de um estado, use o arquivo do estado, trocando sp pela sigla desejada. Para as zonas de uma cidade, use o arquivo de zonas pelo código IBGE do município.

Como montar a planilha passo a passo?

Baixe o arquivo do seu recorte e abra-o em uma ferramenta de planilha que aceite importação de JSON, ou converta-o para CSV com a ferramenta que preferir. Cada linha deve representar uma unidade, como um município ou uma zona, e cada coluna, um candidato ou um indicador, como votos ou percentual. Monte as colunas antes de importar, para não misturar cargos na mesma tabela.

Os votos vêm indexados pelo número do candidato na urna. Por isso, o número é a chave mais segura para cruzar candidatos entre arquivos, mais do que o nome, que pode aparecer escrito de formas diferentes. Junte o número ao cargo e ao estado para não confundir os registros.

Guarde também o horário em que o arquivo foi gerado, que vem no próprio arquivo. Ele diz de que momento da apuração são os números e deve aparecer em qualquer legenda ou nota da sua planilha.

Como montar um mapa com esses dados?

Um mapa precisa de duas coisas: a forma de cada área, como estado, município ou zona, e um valor para pintar cada uma. A forma vem de um arquivo geográfico de sua escolha. O valor vem do JSON. Junte os dois pela chave comum, que deve ser o código IBGE do município quando o recorte for municipal.

Para achar o código IBGE, a página de cada estado lista todos os seus municípios, com o link de cada um. O endereço da página do município termina no código: https://eleicoes2026brasil.com/presidente/sp/3550308 é São Paulo. A ferramenta de busca do servidor MCP também devolve o código.

Se quiser conferir o desenho antes de montar o seu, o mapa da Apuração 2026 tem zoom, navegação de Brasil a estado, município e zona, e modos de cor por vencedor, margem, parcela apurada ou participação de um candidato. Use-o como referência para ver se o seu mapa mostra o mesmo recorte.

Quando atualizar a planilha?

Durante a apuração, os totais são atualizados a cada poucos segundos, assim que o TSE publica novas seções. Por isso, uma planilha feita em um momento fica desatualizada logo depois. Baixe o arquivo de novo antes de cada publicação e substitua os valores, sem misturar linhas de momentos diferentes.

Quando a contagem estiver completa, como a do 1º turno, com 100% das seções apuradas, os números deixam de mudar. Mesmo assim, mantenha o horário de geração na planilha, porque ele é a referência para quem for conferir o seu número depois.

Quais cuidados ao publicar o mapa ou a planilha?

Cite a fonte em cada mapa ou tabela: o Tribunal Superior Eleitoral como origem dos números e a Apuração 2026 como o site de onde o arquivo foi obtido. O site pede essa citação ao republicar, e ela vale também para gráficos feitos com os arquivos JSON.

Publique o que o arquivo traz, com a data e o horário de geração, sem acrescentar causas ou previsões sobre candidatos ou partidos. Se um dado parecer estranho, consulte o portal do TSE, em https://www.tse.jus.br, antes de publicar.

Fontes

Portal de Dados Abertos do TSE: https://dadosabertos.tse.jus.br

Divulgação oficial de resultados do TSE: https://resultados.tse.jus.br