Librería cliente de la API de datos de Euskalmet. Permite obtener y manejar la información de la API de datos abiertos de Euskadi. Cuenta con una serie de modelos de datos y métodos preparados para poder utilizarlos de forma fácil y accesible.
La información que recoge y utiliza esta librería es propiedad de la Agencia Vasca de Meteorología.
ATENCIÓN: Esta librería está en desarrollo y por ello, faltan muchas llamadas a la API de datos de Euskalmet. Abre un issue o un pull request si quieres que esta librería tenga más funcionalidades. Mi tiempo da para lo que da :)
Utiliza pip para instalar la librería:
pip install python-euskalmet
Es importante crear un directorio de configuración en ~/.config/python-euskalmet para que la librería pueda
guardar la configuración.
Obtén tu clave de API en la siguiente web. Luego, hay que soliticar las claves en la web y guardarla
en ~/.config/euskalmet/privateKey.pem.
Por otro lado, hay que definir un fichero de configuración en el directorio ~/.config/euskalmet/settings.cfg con
la siguiente información:
[PAYLOAD]
; Issuer (emisor): description issuer description, ex. company name
iss =
; Timestamp expiration: Ex. 1696081478
exp =
; Emission timestamp: (today's epoch)
iat =
; Api key owner email: Ex. [email protected]
email =
Importante
Destacar, los campos exp y iat son timestamps (epochs). El campo
exp (fecha de expiración) tiene que ser mayor que iat (fecha de emisión del certificado), y dicha emisión la emitirá
el portal de Euskalmet. La fecha de expiración puede ponerse cualquiera, pero siempre más alta que la fecha de hoy.
Del mismo modo, el email tiene que ser el mismo que indicaste en la solicitud de Euskalmet.
Si por ejemplo, se quiere descargar las observaciones de una estación,
from euskalmet import Stations
estacion = Stations() # Inicializa el objeto
estacion.automatic_download("C017", multiprocess=True) # Descarga la información de la estación
Para más información, revisa la documentación.
Para cualquier duda, sugerencia o mejora, siéntete libre de abrir una issue en el repositorio.