Visão geral da API Weather

Com a API Weather, você pode solicitar dados meteorológicos hiperlocais em tempo real para locais do mundo todo. Assim, é possível criar painéis de clima ao vivo, apps de atualização meteorológica, sobreposições de clima em rotas e monitores de saúde ou monitor fitness com base no clima. As informações meteorológicas incluem temperatura atual, precipitação, umidade relativa, velocidade do vento, índice UV e muito mais.

Para um local em uma determinada latitude e longitude, a API fornece endpoints (https://weather.googleapis.com/v1/...) para os dados na tabela a seguir.

Resumo dos endpoints REST

endpoint de API URL Descrição Parâmetros documentados
Condições atuais https://weather.googleapis.com/v1/currentConditions:lookup Condições climáticas em tempo real location.latitude, location.longitude
Previsão de hora em hora https://weather.googleapis.com/v1/forecast/hours:lookup Até 240 horas de condições previstas location.latitude, location.longitude
Previsão diária https://weather.googleapis.com/v1/forecast/days:lookup Até 10 dias de condições previstas location.latitude, location.longitude
Histórico por hora https://weather.googleapis.com/v1/history/hours:lookup Até 24 horas de condições anteriores armazenadas em cache location.latitude, location.longitude
Alertas de condições climáticas adversas https://weather.googleapis.com/v1/publicAlerts:lookup Alertas de condições climáticas adversas key, location.latitude, location.longitude

Casos de uso comuns

Recursos da API Weather

Os dados da API Weather incluem:

  • Condições climáticas e ícones: uma descrição e um ícone correspondente indicando as condições climáticas atuais (por exemplo, "Nublado" ou "Nevasca") em weatherCondition.
  • Temperatura: temperatura atual (temperature), temperaturas mínima e máxima (minTemperature e maxTemperature nas previsões diárias ou dentro de currentConditionsHistory) e temperatura aparente ("sensação térmica") (feelsLikeTemperature).
  • Precipitação: precipitação total e tipo de precipitação (neve, chuva, gelo, mista).
  • Vento: sensação térmica (windChill), direção do vento (wind.direction), velocidade do vento (wind.speed) e rajada (wind.gust).
  • Espessura do gelo: espessura do gelo.
  • Umidade: ponto de orvalho (dewPoint), índice de calor (heatIndex), temperatura de bulbo úmido (wetBulbTemperature) e umidade relativa (relativeHumidity).
  • Índice UV: índice ultravioleta (UV) (uvIndex).
  • Probabilidade de tempestade: a chance percentual de ocorrência de uma tempestade.
  • Visibilidade: a distância em que um objeto é claramente visível.
  • Pressão do ar: a pressão média do ar ao nível do mar.
  • Eventos do Sol e da Lua: horários de nascer e pôr do sol e da lua.
  • Cobertura de nuvens: a porcentagem do céu coberta por nuvens.

Como usar a API Weather

1 Configurar Comece com Configurar seu projeto na nuvem do Google Cloud e siga as instruções.
2 Ver as condições atuais Consulte Receber as condições atuais.
3 Receber previsão por hora Consulte Receber previsão por hora.
4 Receber a previsão do tempo diária Consulte Receber previsão diária.
5 Receber histórico por hora Consulte Receber histórico por hora.
6 Receber alertas de clima Consulte Receber alertas meteorológicos.

Para o índice de qualidade do ar (IQA) e poluentes particulados (PM2,5, PM10), use a API Air Quality (https://airquality.googleapis.com/v1/currentConditions:lookup). A API Weather não retorna esses valores.

Outras APIs ambientais relacionadas incluem:

  • Contagens de pólen: API Pollen (https://pollen.googleapis.com/v1/forecast:lookup)
  • Irradiância solar e potencial de telhado: API Solar (https://solar.googleapis.com/v1/buildingInsights:findClosest)

A seguir