Method: currentConditions.lookup

Retorna as condições climáticas atuais em um determinado local.

Solicitação HTTP

GET https://weather.googleapis.com/v1/currentConditions:lookup

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

Parâmetros de consulta

Parâmetros
location

object (LatLng)

Obrigatório. O local para receber as condições climáticas atuais.
unitsSystem

enum (UnitsSystem)

Opcional. O sistema de unidades a ser usado para as condições climáticas retornadas. Se não for fornecido, as condições climáticas retornadas estarão no sistema métrico (padrão = METRIC).
languageCode

string

Opcional. Permite que o cliente escolha o idioma da resposta. Se não for possível fornecer dados para esse idioma, a API usará a correspondência mais próxima. Os valores permitidos dependem do padrão IETF BCP-47. O valor padrão é "en".

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta para o RPC "currentConditions.lookup", que representa as condições climáticas atuais no local solicitado.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "currentTime": string,
  "timeZone": {
    object (TimeZone)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "currentConditionsHistory": {
    object (CurrentConditionsHistory)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Campos
currentTime

string (Timestamp format)

Hora atual (UTC) associada aos dados retornados.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
timeZone

object (TimeZone)

O fuso horário no local solicitado.
weatherCondition

object (WeatherCondition)

A condição climática atual.
temperature

object (Temperature)

A temperatura atual.
feelsLikeTemperature

object (Temperature)

A medida de como a temperatura está no local solicitado.
dewPoint

object (Temperature)

A temperatura atual do ponto de condensação.
heatIndex

object (Temperature)

A temperatura atual do índice de calor.
windChill

object (Temperature)

A sensação térmica atual, a temperatura do ar exposta na pele.
precipitation

object (Precipitation)

A probabilidade atual e a quantidade de precipitação acumulada na última hora.
airPressure

object (AirPressure)

As condições atuais de pressão do ar.
wind

object (Wind)

As condições atuais de vento.
visibility

object (Visibility)

A visibilidade atual.
currentConditionsHistory

object (CurrentConditionsHistory)

As mudanças nas condições atuais nas últimas 24 horas.
isDaytime

boolean

Verdadeiro se o horário atual no local solicitado estiver entre o nascer do sol (inclusive) e o pôr do sol (exclusivo). Caso contrário, é noite (entre o pôr do sol e o próximo nascer do sol).
relativeHumidity

integer

A porcentagem atual de umidade relativa (valores de 0 a 100).
uvIndex

integer

O índice ultravioleta (UV) atual.
thunderstormProbability

integer

A probabilidade atual de tempestade (valores de 0 a 100).
cloudCover

integer

A porcentagem atual do céu coberta por nuvens (valores de 0 a 100).

Escopos de autorização

Requer o seguinte escopo OAuth:

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

CurrentConditionsHistory

Representa um conjunto de mudanças nas condições atuais nas últimas 24 horas.

Representação JSON 
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Campos
temperatureChange

object (Temperature)

A temperatura atual menos a temperatura de 24 horas atrás.
maxTemperature

object (Temperature)

A temperatura máxima (alta) nas últimas 24 horas.
minTemperature

object (Temperature)

A temperatura mínima (baixa) nas últimas 24 horas.
snowQpf

object (QuantitativePrecipitationForecast)

A quantidade de neve, medida como equivalente de água líquida, que se acumulou nas últimas 24 horas. Observação: QPF é uma abreviação de previsão quantitativa de precipitação. Consulte a definição de "QuantitativePrecipitationForecast" para mais detalhes.
qpf

object (QuantitativePrecipitationForecast)

A quantidade de chuva, medida como equivalente de água líquida, que se acumulou nas últimas 24 horas. Observação: QPF é uma abreviação de previsão quantitativa de precipitação. Consulte a definição de "QuantitativePrecipitationForecast" para mais detalhes.