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).
