Descrição
Os Dados de Preços de Combustível são um agrupamento de informações coletadas por empresas de pesquisa, que tem como objetivo apoiar os procesos de análise econômica de indivíduos, empresas e regiões, bem como apoiar os trabalhos de modelagem de renda, e outras tarefas que possam utilizar informações relacionadas com o custo de vida de uma localidade como um atributo de entrada. As informações de preço coletadas são associadas com o endereço ou região geográfica em função de um raio específico definido. Todos os postos de combustível e preços (atuais e históricos) são retornados. Por padrão, é considerado um raio de 2 kilômetros em torno de um endereço para recuperar os dados de preços.
Além da quantidade total de postos na região, e o preço médio dos diferentes tipos de combustível na mesma, são retornadas também informações relacionadas com o quanto esses preços estão próximos (ou distantes) da média de preço da cidade, do estado e do país como um todo, permitindo assim uma análise comparativa dos dados. Finalmente, são retornados também atributos relacionados com a variação histórica desses preços, fornecendo uma visão evolutiva dos dados.
Origem da Informação
Os dados de preços de combustível são coletados pela Triad Research.
Tabela de preços para esse dataset
Consultas Realizadas no Mês | Valor por consulta |
---|---|
1 - 10000 | R$ 1,200 |
10001 - 50000 | R$ 1,140 |
50001 - 100000 | R$ 1,083 |
100001 - 500000 | R$ 1,029 |
500001 - 1000000 | R$ 0,978 |
1000001 - 5000000 | R$ 0,929 |
5000001 - 10000000 | R$ 0,883 |
10000001 - 50000000 | R$ 0,839 |
50000001 e acima | R$ 0,797 |
Parâmetros de consulta
A tabela abaixo detalha os campos aceitos na consulta a este dataset.
Campo | Descrição | Valores Possíveis | Tipo de Campo |
---|---|---|---|
zipcode | Código postal a consultar | CEP | 🛑 Obrigatório |
householdcode | Código postal | Inscrição da casa | 🔑 Chave Alternativa |
buildingcode | Código postal | Inscrição do prédio | 🔑 Chave Alternativa |
latitude | Latitude (DEVE SER PASSADO COM A LONGITUDE) | Valor da latitude | 🔑 Chave Alternativa |
longitude | Longitude (DEVE SER PASSADO COM A LATITUDE) | Valor da longitude | 🔑 Chave Alternativa |
Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.
Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:
{
"Datasets": "partner_fuellog_fuel_pricing_data_address",
"q": "zipcode{CEP}"
}
Parâmetros opcionais - Data de referência e formato da data
Diferente de outros datasets on-demand, essa consulta permite a passagem de parâmetros opcionais para apoiar o processo de consulta, especificamente a data de referência que deve ser utilizada para a consulta (para apoiar processos de Backtest) e o formato dessa data. A tabela abaixo lista esses parâmetros opcionais e seus valores possíveis.
Parâmetro | Descrição | Valores |
---|---|---|
referencedate | Data de Nascimento do Indivíduo Consultado | Qualquer data válida |
dateformat | Formato da data de nascimento informada | String de formatação da data, como yyyy-MM-dd ou similar |
Parâmetros opcionais - Raio de recuperação dos preços
Esse dataset suporta ainda um segundo parâmetro opcional, chamado radius, que permite ao cliente especificar o raio, em kilômetros, no qual ele quer que os preços de combustível mapeados sejam associados com os endereços da entidade. O valor máximo para esse parâmetro é 2 (2 kilômetros).