Method: lookupWeather

Pesquise as condições climáticas em um local.

Solicitação HTTP

POST https://mapstools.googleapis.com/v1:lookupWeather

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 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
Campos
unitsSystem

enum (UnitsSystem)

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

object (Location)

Obrigatório. O local para o qual as condições climáticas serão consultadas.
capabilities[]

enum (Capability)

Opcional. Os recursos ambientais que serão incluídos na resposta.
date

object (Date)

Opcional. Especifica a data das informações ambientais solicitadas, em relação ao fuso horário local do local especificado no campo location. Os períodos aceitos dependem dos recursos solicitados: - WEATHER: até 24 horas no passado (quando hour também está definido) e até 10 dias (240 horas) no futuro (de hoje até +9 dias para previsões diárias). - AIR_QUALITY: até 30 dias (720 horas) no passado e até 4 dias (96 horas) no futuro. - POLLEN: de hoje até +4 dias (até 5 dias, incluindo hoje; datas históricas não são aceitas).
hour

integer

Opcional. Especifica a hora das informações ambientais solicitadas, no formato de 24 horas (0 a 23), em relação ao fuso horário local do local especificado no campo location. Requer que date seja especificado. Os intervalos por hora aceitos dependem dos recursos solicitados: - WEATHER: até 24 horas no passado e até 240 horas (10 dias) no futuro. - AIR_QUALITY: até 30 dias (720 horas) no passado e até 4 dias (96 horas) no futuro. - POLLEN: retorna apenas previsões diárias. hour é ignorado para pólen.
languageCode

string

Opcional. O código de idioma BCP-47 para texto localizado na resposta (por exemplo, "en", "ja", "fr-CA"). O padrão será "en" se não houver nada especificado.
weatherOptions

object (WeatherOptions)

Opcional. Opções específicas para solicitações de clima. weatherOptions.units_system é compatível com unitsSystem de nível superior (tag 4) para preservar a compatibilidade com versões anteriores para autores de chamadas atuais. Retorna INVALID_ARGUMENT se ambos especificarem sistemas de unidades conflitantes. Ignorado se WEATHER não for solicitado em capabilities.
airQualityOptions

object (AirQualityOptions)

Opcional. Opções específicas para solicitações de qualidade do ar. Ignorado se AIR_QUALITY não for solicitado em capabilities.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de LookupWeatherResponse.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/maps-platform.mapstools