Combustíveis:
preço semanal por município.

Motivação

A ANP publica a pesquisa semanal de preços em uma planilha por semana, com cinco abas. Quem acompanha o preço do posto na cidade, frotistas, transportadores, jornalistas e pesquisadores precisa comparar semanas, cidades e a média do estado e do país em formato estável, com a fonte e a semana de referência.

Composição

Unidade

Produto em um município (ou estado, região, Brasil), em uma semana de domingo a sábado.

Produtos

gasolina-comum, gasolina-aditivada, etanol (hidratado), diesel-s10, diesel (B S500, comum), gnv e glp (botijão de 13 kg). Unidades: R$/l, R$/m³ (GNV) e R$/13kg (GLP).

Campos

postos (pesquisados na semana), preco_medio, preco_minimo, preco_maximo e desvio_padrao, como publicados pela ANP.

Derivados

variação da média contra a semana 4 e 12 semanas antes (absoluta e percentual), média da UF e do Brasil na mesma semana e ranking dos 10 municípios mais baratos e mais caros da UF no produto.

Cobertura: Brasil inteiro, municípios onde a ANP pesquisa (cerca de 2.400 combinações município-produto por semana). Estado atual: as últimas 12 semanas; a série histórica entra por carga noturna única (--historico, desde 09/2022 na página da ANP). A resposta informa a primeira, a última e o total de semanas.

Como é coletado

Fonte oficial

ANP: página "Levantamento de Preços de Combustíveis – últimas semanas pesquisadas" (gov.br/anp), que lista o arquivo resumo_semanal_lpc_<início>_<fim>.xlsx de cada semana, com as abas CAPITAIS, MUNICIPIOS, ESTADOS, REGIOES e BRASIL. A série histórica anterior está em gov.br/anp (série histórica do levantamento de preços).

Método

Coletor próprio (lib/combustiveis.ts, leitor de XLSX sem dependência externa) identificado no User-Agent como "PIRANOT-DataX/1.0". Incremental: a semana já gravada é fixa e não é pedida de novo. A API e a página leem só do estado.

Cadência

A fonte é semanal. A checagem roda sábado e segunda às 06h e traz a semana nova quando a ANP publica. Carga histórica: uma vez, de madrugada (01h-06h), retomável.

Orçamento de requisições

Por rodada: 1 (página da ANP) + 1 por semana que falta, normalmente 0 ou 1; cerca de 4 por semana. Carga inicial das últimas 12 semanas: 13. Histórico: cerca de 200 arquivos de ~300 KB a 1 a cada 2 s. No máximo 1 por segundo; timeout de 60 s; backoff exponencial em 429 e 5xx. Recheque noturno: 5 arquivos por noite.

Túnel

Não há.

Pré-processamento e limpeza

• Datas da planilha (número de série do Excel) convertidas para AAAA-MM-DD; produto da ANP mapeado para um id fixo; estado mapeado para a sigla da UF. Produto ou estado desconhecido reprova a semana.
• Nome do município mantido como a ANP publica (maiúsculas, sem acento); na página e na API aparece também em caixa normal ("Sao Jose do Rio Preto"), sem inventar acento.
• Ranking: do menor para o maior preço médio entre os municípios da UF com o produto pesquisado; desempate pelo maior número de postos e depois pelo nome. Variações arredondadas em 2 casas; desvio padrão em 3. Os preços não são recalculados.

Checks de qualidade aplicados

• Esquema: semana de 7 dias que começa no domingo; semana da planilha igual à anunciada no nome do arquivo; os 7 produtos no Brasil; os 27 estados; produto e estado conhecidos; valores numéricos.
• Faixa: preço médio, mínimo e máximo plausíveis por produto (por exemplo, 2 a 20 R$/l na gasolina, 40 a 250 R$/13kg no GLP).
• Ordem: mínimo ≤ média ≤ máximo (folga de R$ 0,01 de arredondamento), postos inteiro ≥ 1, desvio ≥ 0.
• Soma dos postos: a soma dos municípios fecha com o total do estado e a dos estados com o do Brasil, como a ANP agrega.
• Cobertura e salto: menos de 70% das linhas municipais da semana anterior, ou média nacional de um produto que muda mais de 15% em uma semana, retém a semana para conferência.
• Verificação antes de publicar: os dados passam pelos checks antes de ir ao ar; o que reprova fica retido e a API segue entregando a última versão boa. Recheque noturno: 5 semanas sorteadas, 1 município e produto de cada, conferidos contra o arquivo oficial baixado de novo. Toda resposta informa o resumo qualidade.

Licença e usos

Licença

Dados abertos da ANP; atribuição: "Fonte: ANP, Levantamento de Preços de Combustíveis, processamento PIRANOT".

Usos

Acompanhar o preço do combustível na cidade e a diferença para o estado e o país, comparar municípios, pautas, orçamento de frota e frete. Não substitui o preço de bomba de um posto.

Limitações conhecidas

• O preço é a média de uma amostra de postos na semana (domingo a sábado), não o preço de um posto específico nem de um dia.
• Município com poucos postos pesquisados tem média frágil; o ranking aceita min_postos.
• O produto "óleo diesel" da ANP é o diesel B S500 comum; o S10 é outro produto.
• A ANP não pesquisa todos os municípios e a lista varia de semana para semana.
• Os nomes dos municípios saem sem acento, como na fonte.

Distribuição

Metadados (DCAT / schema.org Dataset)

dct:identifier

combustiveis

dct:publisher

PIRANOT

dct:source

ANP

dct:license

dados abertos da ANP

dct:temporal

últimas 12 semanas (histórico desde 09/2022 por carga única)

dct:spatial

Brasil, por município

dct:accrualPeriodicity

semanal

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.