Volume de tráfego nas praças de pedágio¶
Resumo¶
Volume de tráfego por praça de pedágio informado pelas concessionárias de rodovias federais à ANTT (Superintendência de Infraestrutura Rodoviária). Cada linha é o total de veículos de uma categoria numa praça e sentido em um período. Serve para acompanhar o tráfego pedagiado por rodovia, praça e tipo de veículo.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | antt/volume-trafego-praca-pedagio |
| Órgão | Agência Nacional de Transportes Terrestres (ANTT) |
| Página oficial | https://dados.antt.gov.br/dataset/volume-trafego-praca-pedagio |
| Licença | Creative Commons Attribution (CC BY), conforme o conjunto no portal de dados abertos da ANTT: http://www.opendefinition.org/licenses/cc-by. Nenhuma restrição de uso ou redistribuição foi encontrada além da atribuição; o portal fica atrás de um firewall que rejeita acessos automatizados em excesso (respostas "Request Rejected"), o que limita a coleta. |
| Periodicidade | mensal segundo o portal (a cobertura temporal declarada é anual) |
| Cobertura | 2010 a em-curso |
| Unidade (uma linha) | o volume de veículos de uma praça, sentido, tipo de cobrança e categoria em um mês (arquivos mensais) ou em um dia (arquivos diários) |
| Granularidade | espacial: praça de pedágio, com concessionária e sentido; temporal: mês, ou dia nos arquivos diários de 2024 em diante |
| Formato bruto | CSV (cada recurso do pacote é um arquivo), Windows-1252 na maior parte (alguns UTF-8), separador ponto e vírgula, texto entre aspas só em parte dos arquivos |
| Estado no lake | convertido |
| Partições | ano |
| Chave | — |
| Colunas | 10 |
| Unidades de medida | volume_total: veículos |
| Dados pessoais | nenhum |
| Eras | 2024: categoria dá lugar a categoria_eixo; passam a existir, além dos arquivos mensais consolidados, arquivos diários por concessionária com 3,3 milhões de linhas por ano |
| Revisado em | 2026-11-10 |
| Versão do fetcher | 0.3.2 |
Origem e coleta¶
- O fetcher baixa os recursos CSV do pacote
volume-trafego-praca-pedagiodo portal de dados abertos da ANTT (https://dados.antt.gov.br/dataset/volume-trafego-praca-pedagio), que tem um CSV (e um JSON gêmeo) por ano de 2010 em diante e, desde 2024, versões diárias e mensais consolidadas. - No bruto, os arquivos novos se chamam
volume-trafego-praca-pedagio_<recurso>-<id>@AAAAMMDD.csv, em que o sufixo é a data da última modificação na fonte; os mais antigos têm o nome nu[email protected]. O fetcher descarta documentação (PDF) e o painel; os JSON do pacote não são convertidos. - O pacote tem um arquivo por ano de 2010 a 2023, dois arquivos diários de 2024 (veja os cuidados de uso), e, de 2024 em diante, versões mensal consolidada e diária por ano. O conversor lê um arquivo vigente por recurso; os JSON do pacote não são convertidos.
Conteúdo¶
- Unidade de análise: o volume de uma combinação concessionária, praça, sentido, tipo de cobrança, categoria e tipo de veículo em um mês (ou dia). Chave não verificada.
- Cobertura anunciada pela fonte: 2010 em diante, cobertura temporal "Anual" e atualização "Mensal". O que o lake pode ter: 2010 a 2026, com 2023 inclusive.
- Eras: de 2010 a 2022 a categoria vem em
categoria; de 2024 em diante emcategoria_eixo(código numérico). O dicionário anterior a 2023 usacategoria; o de 2023 usacategoria_eixoeTipo de Cobrança. Ames_anovaria de formato conforme o arquivo:01/MM/AAAA(dia 01) nos mensais de 2010 a 2023,dd/mm/aaaanos diários emm/aaaanos mensais consolidados de 2024 em diante. - Nulos (amostra de 5 arquivos, 429.634 linhas: 2010, 2020, 2021, 2024 mensal e o arquivo de nome nu de 2026, medida antes da coluna
granularidade):categoriaé nula em 60,2% (as linhas dos arquivos de 2024 e 2026) ecategoria_eixoem 39,8% (as dos arquivos até 2021), porque cada era usa uma das duas colunas. Os demais campos não têm nulo na amostra.
Variáveis¶
Descrições do dicionário de dados da ANTT (dois PDFs, o de 2010 a 2022 e o de 2023). Todos os valores chegam ao lake como texto. A coluna de partição ano não está nos arquivos.
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
concessionaria |
concessionaria |
texto | Nome da concessionária que prestou as informações | — | todo |
mes_ano |
mes_ano |
texto | Data de referência. A fonte dá o formato jan-17; nos arquivos conferidos vem como 01/MM/AAAA (sempre o dia 01) nos mensais de 2010 a 2023, como dd/mm/aaaa nos arquivos diários e como mm/aaaa nos mensais consolidados de 2024 em diante |
dd/mm/aaaa ou mm/aaaa |
todo |
sentido |
sentido |
texto | Orientação de direção geral da praça | Crescente, Decrescente |
todo |
praca |
praca |
texto | Nome dado para a praça de pedágio; o formato é livre (por exemplo 2 (Vargem), 1 Sul (Mairiporã)) |
— | todo |
tipo_cobranca |
tipo_cobranca |
texto | Tipo de cobrança. O dicionário de 2023 a chama Tipo de Cobrança |
Manual, Automática, OCR/PLACA, N/I (conferido) |
todo |
categoria |
categoria |
texto | Representação veicular na tabela de tarifas (dicionário anterior a 2023). Valores livres, como Categoria 6 ou Veículo Comercial 3 eixos |
— | 2010 a 2022 |
tipo_de_veiculo |
tipo_de_veiculo |
texto | Classificação veicular | Comercial, Passeio, Moto, Veículo Pequeno (conferido) |
todo |
volume_total |
volume_total |
texto | Volume total de veículos que passaram na praça. Texto com vírgula decimal e ,00 (por exemplo 13,00) |
veículos | todo |
granularidade |
— | texto | Granularidade do arquivo de origem, calculada pelo conversor; não existe na fonte | dia, mes ou nulo (arquivo sem data) |
todo |
categoria_eixo |
categoria_eixo |
texto | Categoria por número de eixos ou da tabela de tarifas (dicionário de 2023, categoria_eixo); nos arquivos conferidos é um código numérico de 1 a 20 como texto |
1 a 20, como texto (conferido) | 2024 em diante |
No lake¶
- Dataset
antt/volume-trafego-praca-pedagio, particionado porano, um Parquet por arquivo de origem. anovem da colunames_ano(qualquer grupo de 4 dígitos na linha, entre 1900 e 2100); linha sem ano válido iria para a partiçãoano=__HIVE_DEFAULT_PARTITION__(não houve na amostra).granularidade(diaoumes) é do arquivo, igual em todas as linhas dele: o arquivo diário e o mensal consolidado do mesmo período caem na mesma partiçãoano, e a coluna os separa. Vale o que o nome do recurso diz (_diario,_mensal_consolidado); sem isso, o arquivo émesquando pelo menos 90% das linhas têmmm/aaaaou o dia 01, ediano resto. Os mensais de 2010 a 2022 (01/MM/AAAA) saemmes. O de 2023 também (99,5% das linhas no dia 01), embora tenha 734 linhas em outras datas:31/01e31/03/2023(CRO, o mês inteiro com data do último dia),02/12/2023(CONCER, idem) e 226 linhas diárias de janeiro da Ecovias do Araguaia; essas linhas ficammescomo o resto do arquivo. Ressalva: um arquivo diário cujo nome não trazdiarioe que só tenha datas no dia 01 (por exemplo, um recorte de um único dia 01) saimes; o nome do recurso, quando existe, prevalece.- Todas as colunas são texto, com nomes normalizados (minúsculas, sem acento). Arquivos UTF-8 e Windows-1252 são lidos com decodificação própria; aspas internas soltas são reparadas.
- Esquema de referência (
volume-trafego-praca-pedagio.schema.json): 10 colunas, gerado de uma conversão de 6 arquivos de amostra (2010, 2020, 2021, 2024 mensal, o arquivo de nome nu de 2026 e o início do diário de 2026).
Cuidados de uso¶
- Dupla contagem entre arquivos diário e mensal. Em 2024, o arquivo mensal consolidado e o arquivo diário (
2024 Diário) somam o mesmo total: 834.732.408 veículos nos dois (143.377 linhas no mensal, 3.312.763 no diário; conferido em 2026-11-10). Os dois caem emano=2024, então somar a partição conta o tráfego duas vezes. Filtregranularidade = "mes"(ou"dia") antes de somar. O mesmo padrão (diário e_mensal_consolidado) vale para 2025 e 2026 pelos nomes de recurso; não foi comparado numericamente. - Dois arquivos diários de 2024. O portal lista, além do
2024 Diário(maio de 2026), o recurso2024de maio de 2025 (volume-trafego-praca-pedagio-2024.csv, nome nu no bruto): 3.358.858 linhas e 848.941.037 veículos, contra 3.312.763 e 834.732.408 do diário novo. São revisões do mesmo período, os dois são vigentes no lake (cada um no seu Parquet) e somargranularidade = "dia"de 2024 conta o ano duas vezes: use um só deles (o2024 Diárioé o mais recente). - Recursos de nome nu se somam aos demais. O bruto tem arquivos de nome nu (
[email protected]), gravados por versões antigas do fetcher que davam o mesmo nome a recursos diferentes do pacote (2023, 2024 e o mensal de 2026, entre outros). A versão vigente é escolhida por recurso (URL do manifesto ao lado), então todos entram, cada um no seu Parquet (volume-trafego-praca-pedagio_<id8>.parquet); o ano de 2023 passa a existir no lake. Um arquivo de nome nu sem manifesto ao lado segue a regra do nome (só o mais recente de cada nome). - Volume é texto com vírgula decimal (
13,00); troque a vírgula por ponto antes de somar. mes_anomuda de formato entre os mensais de 2010 a 2023 (01/MM/AAAA), os diários (dd/mm/aaaa) e os mensais consolidados (mm/aaaa); extraia o mês com cuidado. No arquivo de 2023 algumas linhas têm outra data (vergranularidade): para o mês, use sempre a data inteira, não só a granularidade.- Categorias. Os valores de
categoriaecategoria_eixosão livres e variam entre concessionárias (Categoria 6,Veículo Comercial 3 eixos,10); não há tabela de códigos publicada.
Exemplos¶
Volume mensal de veículos por concessionária em 2024, usando só o arquivo mensal consolidado (o diário repetiria o total):
import polars as pl
vol = pl.scan_parquet("lake/antt/volume-trafego-praca-pedagio/ano=2024/*.parquet")
mensal = (
vol.filter(pl.col("granularidade") == "mes") # só o arquivo mensal consolidado
.with_columns(v=pl.col("volume_total").str.replace(",", ".").cast(pl.Float64))
.group_by("concessionaria", "mes_ano")
.agg(pl.col("v").sum().alias("veiculos"))
.sort("concessionaria", "mes_ano")
.collect()
)
Referências¶
- Pacote: https://dados.antt.gov.br/dataset/volume-trafego-praca-pedagio
- Dicionários de dados (PDF), no pacote: "Volume de Tráfego por Praça" (2010 a 2022) e "Volume de Tráfego por Praça 2023"
- Painel da ANTT (Visualização Gráfica), no pacote