Documentação Técnica

Dados de Preços de Combustível

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êsValor por consulta
1 - 10000R$ 1,200
10001 - 50000R$ 1,140
50001 - 100000R$ 1,083
100001 - 500000R$ 1,029
500001 - 1000000R$ 0,978
1000001 - 5000000R$ 0,929
5000001 - 10000000R$ 0,883
10000001 - 50000000R$ 0,839
50000001 e acimaR$ 0,797

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

CampoDescriçãoValores PossíveisTipo de Campo
zipcodeCódigo postal a consultarCEP🛑 Obrigatório
householdcodeCódigo postalInscrição da casa🔑 Chave Alternativa
buildingcodeCódigo postalInscrição do prédio🔑 Chave Alternativa
latitudeLatitude (DEVE SER PASSADO COM A LONGITUDE)Valor da latitude🔑 Chave Alternativa
longitudeLongitude (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âmetroDescriçãoValores
referencedateData de Nascimento do Indivíduo ConsultadoQualquer data válida
dateformatFormato da data de nascimento informadaString 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).

Language
Authorization
Click Try It! to start a request and see the response here!