Eleições
2026: locais de votação e seções.

Motivação

O TSE publica o eleitorado por local de votação em um arquivo nacional e os boletins de urna um a um. O PIRANOT organiza isso por município, local e seção para que um leitor encontre a própria seção e para que assessorias, pesquisadores e veículos consultem por API.

Composição

Unidade

Local de votação (escola, prédio) e, dentro dele, a seção eleitoral.

Campos do local

slug, nome, endereço, bairro, CEP, zona, nr_local, lat, lon, eleitores.

Campos da seção

secao, principal (seção agregadora), eleitores; no 2º turno de Piracicaba, também aptos, comparecimento, abstenção, brancos, nulos, votos por candidato e o link do boletim de urna no TSE.

Pleito

2026, código TSE 3221 (2º turno, Presidente da República).

Cobertura: 5.757 municípios, 499.248 seções e 28 UFs no catálogo de locais (inclui ZZ, exterior). Resultado por seção: Piracicaba/SP (907 seções, 112 locais, 310.331 eleitores), apuração encerrada em 25/10/2026 às 20h45.

Como é coletado

Fonte oficial

TSE: arquivo de eleitorado por local de votação (cdn.tse.jus.br/estatistica/sead/odsele/eleitorado_locais_votacao/eleitorado_local_votacao_2026.zip) e boletins de urna em resultados.tse.jus.br (pleito 3221).

Método

O coletor é o mesmo do site do PIRANOT (mu-plugin de eleições), que grava o catálogo de locais (_catalogo/municipios.json e _catalogo/<uf>/<cod>.json) e os boletins (t2/<uf>/<cod>.json). O DataX lê esse estado em modo somente leitura (DATAX_ELEICOES_DIR); nenhuma consulta de cliente chega ao TSE.

Cadência

Carga fechada: o catálogo foi gerado em 25/10/2026 15h47 e os boletins apurados até 25/10/2026 20h45. Não há coleta agendada; uma eleição nova é uma carga nova.

Orçamento de requisições

No dia da apuração o coletor do site operou com teto de 3 requisições/segundo e ritmo médio de 1 passada por minuto (registro em t2/_status.json). Fora da apuração: zero requisições ao TSE.

Túnel

Não há.

Pré-processamento e limpeza

• Nomes de municípios e locais ficam como o TSE publica (caixa alta); o slug é gerado pelo PIRANOT.
• Seção sem boletim de urna fica nula: nada é estimado ou preenchido.
• Agregação por local e município é soma direta dos boletins; percentuais são sobre votos válidos (comparecimento menos brancos e nulos).

Checks de qualidade aplicados

• Esquema: UF e slug validados antes de abrir qualquer arquivo (400 para entrada inválida, 404 para município inexistente); seção sem boletim fica nula.
• Totais: soma das seções conferida contra o total do município e contra a página do site (mesma fonte, mesma agregação) antes de publicar.
• Verificação antes de publicar: o coletor grava numa área de espera, roda os checks e só então promove; se algum falhar, o dado fica retido e a API continua servindo a última versão boa. Toda resposta informa last_updated e o resumo qualidade (ok ou divergente, verificado_em, checks_ok).
• Recheque noturno por amostra: não se aplica à carga fechada do TSE; o recheque das eleições é feito contra o banco do site do PIRANOT (mesma fonte).

Licença e usos

Licença

CC-BY (Portal de Dados Abertos do TSE); atribuição obrigatória "TSE, processamento PIRANOT".

Usos

Localizar a seção do leitor; mapas e análises por local; relatórios de mandato; pesquisa. Não serve para identificar o voto de uma pessoa (o menor grão é a seção).

Limitações conhecidas

• O eleitor vota no local, não necessariamente mora perto dele: qualquer cruzamento com o entorno é inferência (ver Metodologia).
• Seções agregadas ("principal") somam várias seções em uma urna; comparar eleições exige comparar por local ou zona.
• Coordenadas de alguns locais podem faltar ou estar imprecisas (geocodificação do TSE).
• Resultado por seção só existe onde o PIRANOT apurou (Piracicaba no 2º turno de 2026).

Distribuição

Metadados (DCAT / schema.org Dataset)

dct:identifier

eleicoes-2026-secoes

dct:publisher

PIRANOT

dct:source

Tribunal Superior Eleitoral

dct:license

CC-BY 4.0

dct:temporal

2026-10-25

dct:spatial

Brasil (5.757 municípios)

dct:accrualPeriodicity

irregular (por eleição)

dcat:distribution

JSON via API v1

Histórico de versões

Reportar erro

POST /api/v1/qualidade/reportar com dataset, chave_registro, valor_visto, valor_esperado e fonte_esperada (detalhes em /docs/qualidade). Correções confirmadas aparecem em /erratas. Sem chave, escreva para [email protected].

Aviso. O DataX PIRANOT organiza dados de fontes oficiais e pode conter erros ou atrasos. Confira na fonte oficial, indicada em cada dado, antes de qualquer decisão importante. Respostas geradas por IA podem errar.DataX PIRANOT organises data from official sources and may contain errors or delays. Check the official source, linked with each dataset, before any important decision. AI-generated answers can be wrong.