Method: history.lookup

Retorna o histórico de qualidade do ar de um local específico para um determinado período.

Solicitação HTTP

POST https://airquality.googleapis.com/v1/history:lookup

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "pageSize": integer,
  "pageToken": string,
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "dateTime": string,
  "hours": integer,
  "period": {
    object (Interval)
  }
  // End of list of possible types for union field time_range.
  "universalAqi": boolean,
  "languageCode": string
}
Campos
pageSize

integer

Opcional. O número máximo de registros de informações por hora retornados por página. O padrão é 72 e o valor máximo é 168 (sete dias de dados).
pageToken

string

Opcional. Um token de página recebido de uma chamada de histórico anterior. Ele é usado para recuperar a página subsequente.

Ao fornecer um valor para esse parâmetro, todos os outros parâmetros fornecidos precisam corresponder à chamada que forneceu o token da página (a chamada anterior).
location

object (LatLng)

Obrigatório. A latitude e a longitude para as quais a API procura os dados históricos da qualidade do ar.
extraComputations[]

enum (ExtraComputation)

Opcional. Recursos adicionais que podem ser ativados opcionalmente. Especificar cálculos extras faz com que os elementos e campos relevantes sejam retornados na resposta.
uaqiColorPalette

enum (ColorPalette)

Opcional. Determina a paleta de cores usada para os dados fornecidos pelo "Índice Universal de Qualidade do Ar" (UAQI, na sigla em inglês). Essa paleta de cores é relevante apenas para UAQI. Outros IQAs têm uma paleta de cores predeterminada que não pode ser controlada.
customLocalAqis[]

object (CustomLocalAqi)

Opcional. Expressa um "país/região para o IQA" relação. Combina um país/região com um IQA desejado para que os dados de qualidade do ar necessários para esse local sejam mostrados de acordo com o IQA escolhido. Esse parâmetro pode ser usado para especificar um IQA não padrão para um determinado país, por exemplo, para receber o índice EPA dos EUA para o Canadá, em vez do índice padrão para o Canadá.
dateTime

string (Timestamp format)

Um carimbo de data/hora para o qual retornar dados históricos. O carimbo de data/hora é arredondado para a hora exata anterior.

Observação: isso retornará dados por hora somente para o carimbo de data/hora solicitado (ou seja, um único elemento de informação de hora em hora). Por exemplo, uma solicitação enviada quando o parâmetro dateTime está definido como 2023-01-03T11:05:49Z é arredondada para 2023-01-03T11:00:00Z.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

Observação:é possível usar dateTime ou startTime e endTime em uma solicitação.
hours

integer

Número de 1 a 720 que indica o intervalo de horas da solicitação. Por exemplo: o valor 48 produz dados das últimas 48 horas.
period

object (Interval)

Indica o período startTime e endTime para o qual receber os dados históricos. O carimbo de data/hora é arredondado para a hora exata anterior.

Observação:é possível usar dateTime ou startTime e endTime em uma solicitação.
universalAqi

boolean

Opcional. Se definido como verdadeiro, o IQA universal será incluído nos "índices" da resposta. O valor padrão é true.
languageCode

string

Opcional. Permite que o cliente escolha o idioma da resposta. Se os dados não puderem ser fornecidos para esse idioma, a API usará a correspondência mais próxima. Os valores permitidos dependem do padrão IETF. O valor padrão é en.

Corpo da resposta

Se bem-sucedido, o corpo da resposta exibirá os dados com a seguinte estrutura:

Representação JSON 
{
  "hoursInfo": [
    {
      object (HourInfo)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
Campos
hoursInfo[]

object (HourInfo)

Opcional. Contém as informações sobre a qualidade do ar para cada hora no intervalo solicitado. Por exemplo, se a solicitação for de 48 horas de histórico, haverá 48 elementos de informações por hora.
regionCode

string

Opcional. O código ISO_3166-1 alfa-2 do país/região correspondente ao local fornecido na solicitação. Esse campo pode ser omitido da resposta se o local indicado na solicitação residir em um território disputado.
nextPageToken

string

Opcional. O token para recuperar a próxima página.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte a Visão geral do OAuth 2.0.

HourInfo

Contém as informações sobre a qualidade do ar para cada hora no intervalo solicitado. Por exemplo, se a solicitação for de 48 horas de histórico, haverá 48 elementos de informações por hora.

Representação JSON 
{
  "dateTime": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
Campos
dateTime

string (Timestamp format)

Carimbo de data/hora arredondado para baixo que indica a hora a que os dados se referem em RFC3339 UTC "Zulu" com resolução de nanossegundos e até nove dígitos fracionários. Por exemplo: "2014-10-02T15:00:00Z".
indexes[]

object (AirQualityIndex)

Com base nos parâmetros da solicitação, essa lista vai incluir até dois índices de qualidade do ar:

  • IQA universal. Será retornado se o booleano universalAqi estiver definido como verdadeiro.
  • IQA local. Será retornado se o cálculo extra de LOCAL_AQI for especificado.
pollutants[]

object (Pollutant)

Uma lista de poluentes que afetam o local especificado na solicitação. Observação: este campo será retornado apenas para solicitações que especificaram um ou mais dos seguintes cálculos extras: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
healthRecommendations

object (HealthRecommendations)

Orientações de saúde e ações recomendadas relacionadas às condições de qualidade do ar relatadas. As recomendações são adaptadas de maneira diferente para populações de risco, grupos com maior sensibilidade a poluentes e população em geral.