Download de dados eleitorais para análises longitudinais usando R

O Tribunal Superior Eleitoral (TSE) disponibiliza para download um vasto conjunto de microdados eleitorais em seu Portal de Dados Abertos. Nesta breve postagem, eu crio uma função exemplo para gerar as urls que armazenam as tabelas contidas no portal. A função é útil em análises longitudinais.

Note que make_urls monta os endereços para tabelas de eleitorado, de detalhes da votação por seção eleitoral e de votação nominal por município e zona. Para montar outras urls, como as dos boletins de urna, make_urls terá que ser ajustada para lidar com o padrão das urls dos boletins, que é distinto. Outras urls, como as de votação nominal por seção eleitoral, seguem o mesmo padrão e podem ser incorporadas a lista de elementos presente no código abaixo.

Monta as urls

## Função para gerar os links
make_urls = function(x) {
  urls = lapply(x, function(x) {
    y = list(
      eleitorado = paste0("https://cdn.tse.jus.br/estatistica/sead/odsele/perfil_eleitorado/perfil_eleitorado_", x, ".zip"),
      votacao_detalhes = paste0("https://cdn.tse.jus.br/estatistica/sead/odsele/detalhe_votacao_secao/detalhe_votacao_secao_", x, ".zip"),
      votacao_nominal_zona = paste0("https://cdn.tse.jus.br/estatistica/sead/odsele/votacao_candidato_munzona/votacao_candidato_munzona_", x, ".zip")
      ## para o download de outras tabelas, repita a estrutura acima. 
      ## "rótulo = paste("início da url", ano, "final da url")"
    )
    setNames(y, paste0(names(y), x))
  })
  unlist(urls, recursive = FALSE)
} 

## Cria os links
year = seq(1994, 2022, by = 4)

urls = make_urls(year)
urls

$eleitorado1994
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/perfil_eleitorado/perfil_eleitorado_1994.zip"

$votacao_detalhes1994
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/detalhe_votacao_secao/detalhe_votacao_secao_1994.zip"

$votacao_nominal_zona1994
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/votacao_candidato_munzona/votacao_candidato_munzona_1994.zip"

$eleitorado1998
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/perfil_eleitorado/perfil_eleitorado_1998.zip"

$votacao_detalhes1998
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/detalhe_votacao_secao/detalhe_votacao_secao_1998.zip"

$votacao_nominal_zona1998
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/votacao_candidato_munzona/votacao_candidato_munzona_1998.zip"

$eleitorado2002
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/perfil_eleitorado/perfil_eleitorado_2002.zip"

$votacao_detalhes2002
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/detalhe_votacao_secao/detalhe_votacao_secao_2002.zip"

$votacao_nominal_zona2002
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/votacao_candidato_munzona/votacao_candidato_munzona_2002.zip"

$eleitorado2006
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/perfil_eleitorado/perfil_eleitorado_2006.zip"

$votacao_detalhes2006
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/detalhe_votacao_secao/detalhe_votacao_secao_2006.zip"

$votacao_nominal_zona2006
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/votacao_candidato_munzona/votacao_candidato_munzona_2006.zip"

$eleitorado2010
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/perfil_eleitorado/perfil_eleitorado_2010.zip"

$votacao_detalhes2010
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/detalhe_votacao_secao/detalhe_votacao_secao_2010.zip"

$votacao_nominal_zona2010
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/votacao_candidato_munzona/votacao_candidato_munzona_2010.zip"

$eleitorado2014
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/perfil_eleitorado/perfil_eleitorado_2014.zip"

$votacao_detalhes2014
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/detalhe_votacao_secao/detalhe_votacao_secao_2014.zip"

$votacao_nominal_zona2014
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/votacao_candidato_munzona/votacao_candidato_munzona_2014.zip"

$eleitorado2018
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/perfil_eleitorado/perfil_eleitorado_2018.zip"

$votacao_detalhes2018
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/detalhe_votacao_secao/detalhe_votacao_secao_2018.zip"

$votacao_nominal_zona2018
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/votacao_candidato_munzona/votacao_candidato_munzona_2018.zip"

$eleitorado2022
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/perfil_eleitorado/perfil_eleitorado_2022.zip"

$votacao_detalhes2022
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/detalhe_votacao_secao/detalhe_votacao_secao_2022.zip"

$votacao_nominal_zona2022
[1] "https://cdn.tse.jus.br/estatistica/sead/odsele/votacao_candidato_munzona/votacao_candidato_munzona_2022.zip"

Download das tabelas

remotes::install_github("arturhgq/dtools")
files = dtools::download.files(urls)