Descripción general de la API de Weather

La API de Weather te permite solicitar datos meteorológicos hiperlocales en tiempo real para ubicaciones de todo el mundo con el objetivo de potenciar paneles meteorológicos en vivo, apps de actualización del clima, superposiciones de clima en rutas y monitores de actividad o salud basados en el clima. La información meteorológica incluye la temperatura actual, las precipitaciones, la humedad relativa, la velocidad del viento, el índice UV y mucho más.

Para una ubicación en una latitud y longitud determinadas, la API proporciona extremos (https://weather.googleapis.com/v1/...) para los datos de la siguiente tabla.

Resumen de los extremos de REST

Extremo de API URL Descripción Parámetros documentados
Condiciones actuales https://weather.googleapis.com/v1/currentConditions:lookup Condiciones climáticas en tiempo real location.latitude, location.longitude
Pronóstico por hora https://weather.googleapis.com/v1/forecast/hours:lookup Hasta 240 horas de condiciones previstas location.latitude, location.longitude
Pronóstico diario https://weather.googleapis.com/v1/forecast/days:lookup Hasta 10 días de condiciones previstas location.latitude, location.longitude
Historial por hora https://weather.googleapis.com/v1/history/hours:lookup Hasta 24 horas de condiciones pasadas almacenadas en caché location.latitude, location.longitude
Alertas de clima extremo https://weather.googleapis.com/v1/publicAlerts:lookup Alertas de clima extremo key, location.latitude, location.longitude

Casos de uso habituales

Funciones de la API de Weather

Los datos de la API de Weather incluyen lo siguiente:

  • Condiciones climáticas e íconos: Una descripción y el ícono correspondiente que indican las condiciones climáticas actuales (por ejemplo, "Nublado" o "Nevadas dispersas") en weatherCondition.
  • Temperatura: Temperatura actual (temperature), temperaturas mínima y máxima (minTemperature y maxTemperature en los pronósticos diarios o dentro de currentConditionsHistory) y temperatura aparente ("sensación térmica") (feelsLikeTemperature).
  • Precipitación: Precipitación total y tipo de precipitación (nieve, lluvia, hielo, mezcla).
  • Viento: Sensación térmica (windChill), dirección del viento (wind.direction), velocidad del viento (wind.speed) y ráfagas (wind.gust).
  • Grosor del hielo: Es el grosor del hielo.
  • Humedad: Punto de condensación (dewPoint), índice de calor (heatIndex), temperatura de bulbo húmedo (wetBulbTemperature) y humedad relativa (relativeHumidity).
  • Índice UV: Índice de radiación ultravioleta (UV) (uvIndex).
  • Probabilidad de tormenta eléctrica: Es el porcentaje de probabilidad de que ocurra una tormenta eléctrica.
  • Visibilidad: Es la distancia a la que un objeto es claramente visible.
  • Presión del aire: Es la presión promedio del aire al nivel del mar.
  • Eventos del sol y la luna: Horas de salida y puesta del sol y de la luna.
  • Nubosidad: Es el porcentaje del cielo cubierto por nubes.

Cómo usar la API de Weather

1 Inicia la configuración Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones que se indican a continuación.
2 Obtén las condiciones actuales Consulta Obtén las condiciones actuales.
3 Obtener el pronóstico por hora Consulta Obtén el pronóstico por hora.
4 Obtén el pronóstico diario Consulta Cómo obtener el pronóstico diario.
5 Obtén el historial por hora Consulta Obtén el historial por hora.
6 Cómo recibir alertas del clima Consulta Cómo recibir alertas meteorológicas.

Para el índice de calidad del aire (ICA) y los contaminantes particulados (PM2.5 y PM10), usa la API de Air Quality (https://airquality.googleapis.com/v1/currentConditions:lookup). La API de Weather no devuelve estos valores.

Otras APIs ambientales relacionadas incluyen las siguientes:

  • Recuentos de polen: API de Pollen (https://pollen.googleapis.com/v1/forecast:lookup)
  • Irradiancia solar y potencial de energía solar en techos: API de Solar (https://solar.googleapis.com/v1/buildingInsights:findClosest)

¿Qué sigue?