mi comienzo
Primero la interfaz, luego el pipeline
Austria fue mi primer país. Al principio no obtuve los datos a través de la API, sino directamente a través de la interfaz gráfica de GeoSphere: Datos de la estación klima-v2-1m.
Así es también como descargué todos los fondos históricos. Para el primer prototipo, para ser honesto, todavía no quería ocuparme de la API y abrir un segundo sitio de construcción. A través de la interfaz gráfica llegué a los datos con relativa rapidez, aunque seguía alcanzando límites. Especialmente en el caso de Austria y su larguísima serie histórica, este camino manual acabó resultando bastante tedioso.
Sin embargo, precisamente estos datos rápidamente disponibles fueron enormemente importantes para el proyecto. No sé si habría seguido construyendo Crónica Climática si primero hubiera tenido que dedicar mucho tiempo al acceso a datos, API y diferentes formatos. Al principio quería ver si mi idea podía funcionar; Sobre todo, no estaba seguro de poder visualizar miles de emisoras al mismo tiempo de forma dinámica.
Los datos simplemente tenían que estar ahí para que pudieran surgir el tablero, el mapeador y, más tarde, toda la cadena de procesamiento. Para empezar, fue decisivo que Austria pudiera entregar un gran volumen de datos históricos de medición de forma sencilla y sin barreras.
La integración API
Claramente estructurado y investigable en alemán.
En medio del flujo de países, en agosto de 2026, llegó el momento de integrar adecuadamente a Austria. La API de GeoSphere está claramente estructurada: el host, la versión, el tipo, el modo y el ID del recurso siguen un esquema fijo. La documentación es comprensible y, después de toda una serie de documentos en idiomas extranjeros, trabajar en mi lengua materna es mucho más agradable. ¡Eso ahorra tiempo!
El punto final de metadatos entrega la lista de estaciones, los parámetros y el período del conjunto de datos directamente. La serie comienza en 1768. Para los ID de estación ya integrados, solo tuve que eliminar el prefijo AT_ y el resto coincidía directamente con la API.
Los datos históricos y actuales pasan por el mismo punto final klima-v2-1m. La única diferencia es el rango de tiempo. Columnas como time, station, tl_mittel, tlmax, rr y las métricas restantes se reconocen directamente mediante un perfil de importación AT dedicado. Tan pronto como llega el CSV, el mapeo y el procesamiento posterior se activan sin desvíos.
Hasta ahora, AT ha sido, con diferencia, la integración más sencilla. La velocidad y los límites son los mejores de todos los países hasta ahora: GeoSphere entrega los datos de manera increíblemente rápida y limpia.
Límites y corte
Límites transparentes y el tamaño de bloque adecuado
Los límites oficiales son: 5 solicitudes por segundo, 240 por hora y un máximo de 1.000.000 de valores por solicitud. Con bloques de aproximadamente 100 estaciones y 30 años más las 11 mediciones actualmente activas y 11 indicadores de calidad, te quedas por debajo del millón. Para la primera importación histórica, bastan unas 108 solicitudes. El encabezado de respuesta datapoint-count también muestra el tamaño de la solicitud realmente calculado.
Eso hace que la descarga sea extremadamente rápida.
Una comparación aproximada: el paquete AT de datos históricos tarda unos 2 minutos en descargarse y tiene un tamaño de unos 200 MB. Por el contrario, el paquete de Noruega con una arquitectura similar tardó unos 100 minutos y ocupaba unos 4 GB (mucho más lento y mucho más grande), aunque solo descargué las métricas necesarias de todos los años. Vale, Noruega tiene el triple de estaciones; En cambio, Austria tiene series mucho más largas, e incluso si se escala en un factor de 3, se puede ver claramente que AT ha construido esto de manera muy eficiente.
Las solicitudes aún deben dividirse con cuidado. Las estaciones o bloques de tiempo que son demasiado grandes exceden el límite de valor. Mantén los bloques limpios y permanecerás en la zona segura.
¿Qué fue problemático?
La GUI salvó el inicio: la API maneja el uso continuo
La interfaz gráfica es suficiente para el primer acceso, pero no para una descarga de producción normal y reproducible. Con poco más de 1.000 estaciones y unos 260 años de historia, sigues alcanzando límites. Es por eso que la primera ruta de la GUI salvó el proyecto, pero no fue una solución duradera.
Por cierto, el antiguo host dataset.api.hub.zamg.ac.at ya no se debe utilizar. Los redireccionamientos finalizaron a principios de 2026. Cualquiera que siga utilizando enlaces o scripts antiguos llegará a un callejón sin salida.
Austria fue el impulso inicial de Crónica Climática: rápidamente disponible, sólido en sustancia y accesible a través de la interfaz al principio. La API en sí está muy bien hecha y, en comparación con otros países, es agradablemente clara y muy transparente. Incluso hay un Registro de cambios de API (Me encanta 😁) donde se comunican mejoras y nuevas funciones de forma continua.
Una cosa me llamó la atención: al pasar de klima-v1 a klima-v2, se cambiaron los nombres de los parámetros, entre otras cosas. Para mí eso no fue un problema ahora, porque comencé directamente con la v2. Sin embargo, para una futura v3, sería mejor mantener los nombres antiguos como alias; de lo contrario, aún tendría que adaptarse bastante.
Fuentes y material de trabajo.