Preguntas frecuentes sobre la API de Weather

Información general

¿Cómo diferenciarías la API de Weather de Google de los proveedores de datos meteorológicos especializados?

Google está integrando la tecnología de nuestra adquisición de una empresa meteorológica de renombre con los avances de los modelos de IA MetNet y WeatherNext de Google DeepMind (2025). Esto aprovecha la confiabilidad comprobada de Google Maps Platform.

¿Cuál es la diferencia entre los datos meteorológicos disponibles en Earth Engine y BigQuery, y la API de Weather de Google?

El paquete de productos meteorológicos de Google ofrece una amplia gama de soluciones para diversas necesidades. Los modelos de WeatherNext (es decir, GraphCast y GenCast) proporcionan resultados de previsión de modelos sin procesar basados en IA, incluidos parámetros ideales para la investigación, el modelado y el análisis, que están disponibles a través de código de código abierto y conjuntos de datos meteorológicos históricos o actuales con las APIs de Earth Engine y BigQuery.

Por el contrario, la API de Weather de Google Maps Platform ofrece datos climáticos procesados para condiciones actuales y pronósticos diarios y por hora, combinando IA y sistemas tradicionales de pronóstico en un formato fácil de usar para los desarrolladores que se integra sin problemas en apps y servicios web. Este enfoque doble satisface tanto las necesidades de investigación especializada como la accesibilidad amplia para desarrolladores.

¿Por qué Google no se basa únicamente en las mediciones de las estaciones meteorológicas?

Google usa una variedad de fuentes de entrada para su modelo meteorológico, incluidas observaciones de estaciones meteorológicas, modelos numéricos de predicción meteorológica y modelos de IA meteorológica. El motivo por el que se usan estas diversas fuentes de entrada es que las observaciones de las estaciones meteorológicas solo proporcionan información sobre el clima en la ubicación de la estación en el momento de la medición. Las observaciones de las estaciones meteorológicas pueden ser muy precisas para ese punto exacto, pero los fenómenos meteorológicos, como las precipitaciones, en especial las lluvias o tormentas eléctricas, suelen ser localizados y pueden variar de forma significativa en una distancia corta.

Por ejemplo, puede haber un aguacero justo en la ubicación de la estación, mientras que, a unos kilómetros de distancia, solo hay una llovizna ligera o no llueve en absoluto. Debido a que es posible que la lectura de una sola estación no sea representativa de un área más amplia, se necesitan modelos para proporcionar información adicional entre las estaciones.

Además, las estaciones meteorológicas suelen proporcionar lecturas cada hora o media hora. Incluso si se proporcionan casi en tiempo real, puede haber una pequeña demora entre los eventos de precipitación reales y su informe. Los modelos también ayudan a obtener las condiciones actuales lo más cerca posible de la realidad experimentada en la ubicación consultada.

Uso de la API

¿Cuál es la cobertura de la API de Weather?

La API de Weather admite todos los países del mundo, excepto los territorios prohibidos. En Japón y Corea del Sur, los datos meteorológicos los proporciona Weathernews Inc., un operador de servicios meteorológicos con licencia oficial.

En el caso de las ubicaciones en Indonesia, la API de Weather solo está disponible para uso interno.

¿Cuál es el nivel de detalle espacial de la API de Google Weather?

La resolución de los datos es tal que se crean previsiones en un radio de pocos kilómetros para cualquier ubicación del mundo.

¿Cuál es la frecuencia de actualización de la API de Weather?

Extremo Condiciones actuales Pronóstico por hora Pronóstico diario Historial por hora
Frecuencia de actualización Se calcula en tiempo real. Se actualiza cada hora. Se actualiza cada hora. Dos veces al día (7 a.m. y 7 p.m., hora estándar del Pacífico)
  • Precipitaciones a corto plazo (primeras 12 horas del pronóstico): Se actualizan cada 2 a 15 minutos con modelos de pronóstico inmediato de alta resolución y de radar.
  • Horizonte de precipitaciones extendido y sin precipitaciones (hasta 10 días): Se actualiza cada hora para garantizar la orientación de previsión más actualizada.

¿La API de Weather proporciona pronósticos de precipitaciones inmediatos?

Google no proporciona pronósticos inmediatos (pronósticos por minuto) en la API, pero sí proporciona condiciones actuales, pronósticos por hora y pronósticos diarios.

¿La API de Weather proporciona valores de UVA y UVB por separado?

El índice UV es un índice único que combina los rayos UVA y UVB. No proporcionamos un desglose por componente.

¿Cómo produce la API de Weather un resultado de previsión?

Como se muestra en el siguiente diagrama, los pronósticos de la API de Weather se crean a partir de un sistema de pronóstico interno que usa observaciones y modelos meteorológicos de agencias climáticas globales como entradas. Los datos de los sensores meteorológicos públicos de verdad fundamental se usan para mejorar el modelo de previsión.

Diagrama del modelo de previsión de la API de Weather

¿Cuál es la precisión del pronóstico de Google Clima para diferentes regiones y horizontes de pronóstico en comparación con los pronósticos de las principales agencias meteorológicas gubernamentales?

Las cifras de la Tabla 1 comparan la raíz cuadrada del error cuadrático medio (RMSE) de la temperatura y la velocidad del viento para un horizonte de previsión de 240 horas (10 días) entre los datos de Google Clima y los modelos meteorológicos globales y regionales de organismos gubernamentales durante 11 meses (del 15 de agosto de 2024 al 1 de julio de 2025).

A nivel global, el pronóstico de Google Clima supera a los pronósticos de los principales organismos gubernamentales. En el caso de Europa y Norteamérica, los datos de Google Clima tienen un error menor que los modelos gubernamentales regionales más precisos, al menos en la última parte de sus horizontes de previsión. El excelente rendimiento de los datos meteorológicos de Google para horizontes de previsión más largos es particularmente notable, ya que puede ser el más difícil de predecir con exactitud.

En la tabla 1, se enumeran los valores promedio de RMSE para todos los horizontes de previsión pertinentes para cada combinación de modelo y región. Un valor de RMSE más bajo indica un mejor rendimiento. Los pronósticos de Google Clima tienen los valores de RMSE promedio más bajos, o entre los más bajos, para casi todos los parámetros, las regiones y los rangos de horizonte de pronóstico.

Haz clic en una imagen para ver una versión expandida.

Temperatura Velocidad del viento
Global
Norteamérica
Europa

Tabla 1: Valores promedio de RMSE para cada combinación de modelo regional

En la Tabla 2, se enumeran los valores promedio de RMSE para los horizontes de previsión pertinentes de cada modelo (los valores de Google se muestran en negrita). Los parámetros (temperatura, viento) y los horizontes de previsión para los que Google tiene el RMSE promedio más bajo se destacan en verde oscuro. Los parámetros y los horizontes de previsión para los que Google tiene el RMSE promedio más bajo junto con otros modelos se destacan en verde claro.

Valores promedio de RMSE para los horizontes de previsión pertinentes Tabla 2. Valores promedio de RMSE para los horizontes de previsión pertinentes por modelo

¿El extremo de datos históricos refleja los datos meteorológicos reales (es decir, verificados por mediciones locales)?

Los datos meteorológicos históricos son, principalmente, resultados de modelos. Si bien incorpora observaciones de agencias meteorológicas globales y modelos de predicción meteorológica numérica (NWP), estos se asimilan en el modelo de Google Clima para crear un registro histórico completo y coherente. Las mediciones reales de las estaciones se consideran "verdad fundamental" en sus ubicaciones específicas, pero su distribución global limitada las hace insuficientes para obtener un panorama mundial completo.

Estos campos proporcionan información distinta, pero relacionada, sobre las precipitaciones y el clima en general.

  • weatherCondition: Este campo proporciona una descripción general e intuitiva de las condiciones climáticas generales en el área consultada, teniendo en cuenta varios parámetros para facilitar la comprensión.
  • precipitation.probability.percent (PoP): Representa la probabilidad de precipitación. Es la probabilidad de que se produzcan precipitaciones en la ubicación del pronóstico durante el período definido (por lo general, por hora).
  • precipitation.qpf.quantity (QPF): Significa pronóstico cuantitativo de precipitaciones y, además, indica la cantidad esperada de precipitaciones, medida como una profundidad (por ejemplo, milímetros o pulgadas). Este valor representa la cantidad de precipitación que se espera si se produce dentro de la hora y la ubicación especificadas.

¿Cómo puedo determinar si está lloviendo o no en una ubicación determinada?

Te recomendamos que uses el campo weatherCondition para comprender si llueve o no en una ubicación determinada. Varias condiciones pueden indicar que está lloviendo (RAIN, LIGHT RAIN, RAIN SHOWERS, HEAVY RAIN, WIND AND RAIN, THUNDERSTORM, HEAVY THUNDERSTORM, THUNDERSHOWER, SCATTERED SHOWERS, LIGHT THUNDERSTORM RAIN, SCATTERED THUNDERSTORMS, RAIN AND SNOW). Estas condiciones están diseñadas para capturar todas las instancias de lluvia ligera, fuerte, continua o dispersa, y también diferenciar la lluvia de la nieve. Según tu caso de uso específico, por ejemplo, si tu caso de uso solo considera lluvias intensas, puedes optar por usar solo un subconjunto pertinente de estas condiciones.

¿Las "condiciones actuales" equivalen a las observaciones en las ubicaciones de las estaciones meteorológicas? ¿Cómo se determinan las "condiciones actuales" en las ubicaciones sin estaciones?

Nuestras "condiciones actuales" proporcionan la información meteorológica más actualizada combinando varias fuentes de datos, pero no equivalen estrictamente a las observaciones directas de las estaciones en todos los casos.

Para precipitation.probability.percent y precipitation.qpf.quantity (acumulados durante la última hora), el valor que se presenta en la respuesta de currentConditions siempre se deriva de la previsión más reciente. La probabilidad en sí es una cantidad modelada, no observada directamente.

Este enfoque nos permite proporcionar "condiciones actuales" integrales incluso en áreas sin cobertura directa de sensores, lo que garantiza la mejor información disponible en todo momento.

Límites y acceso a la API

¿Existe un límite de frecuencia para la API?

Para la API de Weather, hay un límite de frecuencia predeterminado de 6,000 consultas por minuto.

¿Puedo acceder a los datos de forma masiva?

Los datos masivos no están disponibles. Puedes consultar la API de Weather dentro de la cuota (6,000 QPM) y respetar las condiciones de almacenamiento en caché que se describen en las Condiciones del Servicio.

¿Debo habilitar la facturación?

Se requiere una cuenta de facturación válida para usar la API de Weather. Consulta Habilita la facturación para configurar tu proyecto con una cuenta de facturación.

¿Qué sucede si consulto una ubicación que no es compatible?

Si la latitud y la longitud no están incluidas en la lista de países admitidos, la respuesta devolverá un código de error 404 con el mensaje "Information is unavailable for this location. Prueba con otra ubicación".