Python API for Euskalmet (https://www.euskalmet.euskadi.eus/hasiera/) open data
Project description
Python Euskalmet
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 :)
Instalación
Utiliza pip para instalar la librería:
pip install python-euskalmet
Configuración
Es importante crear un directorio de configuración en ~/.config/python-euskalmet
para que la librería pueda
guardar la configuración.
API Key
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
.
Ficheros de configuración
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. name@company.com
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.
Usar la librería
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.
¿Dudas, sugerencias?
Para cualquier duda, sugerencia o mejora, siéntete libre de abrir una issue en el repositorio.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for python_euskalmet-0.3.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bc059f5c999b7a2f0600272f9c96b4e997798d0f46307137643efd3b501da9ca |
|
MD5 | 40298681e806ab285869efc8b345bf4d |
|
BLAKE2b-256 | 7179b7584e8ca93e50645839cf3d8cf663139785c2b08eee5f224f9d8bbc74c8 |