aemetdata 0.1.3

Paquete Python para descargar datos de AEMET OpenData

aemetdata

Índice rápido

• Instalación
• Obtención de API Key
• Cuaderno de ejemplos interactivo
• Cliente y funciones principales
• Avisos
• Climatología
• Imágenes
• Observaciones

aemetdata es un paquete Python para descargar y procesar datos meteorológicos de AEMET OpenData de forma sencilla y eficiente.

La información que recoge y utiliza esta librería es propiedad de la Agencia Estatal de Meteorología.

Instalación

pip install aemetdata

Obtención de API Key

Necesitas una API Key de AEMET OpenData. Puedes obtenerla en: Obtener clave api AEMET

Puedes probar todas las funciones del paquete directamente en Google Colab usando este cuaderno de ejemplo.

Cliente y funciones principales

AemetClient

Clase principal para interactuar con la API de AEMET OpenData. Permite descargar datos de cualquier endpoint autorizado.

Ejemplo de uso:

from aemetdata import AemetClient

client = AemetClient(api_key=API_KEY)
endpoint = "valores/climatologicos/diarios/datos/fechaini/2024-01-01T00:00:00UTC/fechafin/2024-01-02T00:00:00UTC/todasestaciones"
data = client.download_data(endpoint)
print(data[:500])

Avisos

aemetdata.avisos: Funciones para descargar avisos meteorológicos oficiales:

• avisos_area_ultimo_eleaborado(codigo_area, api_key): Descarga el último aviso elaborado para un área específica.

  from aemetdata.avisos import avisos_area_ultimo_eleaborado
  ruta = await avisos_area_ultimo_eleaborado("72", [API_KEY])
  print(f"Archivo guardado: {ruta}")
  

• avisos_por_fechas(fecha_ini, fecha_fin, api_key): Descarga todos los avisos entre dos fechas.

  from aemetdata.avisos import avisos_por_fechas
  rutas = await avisos_por_fechas('2026-01-01', '2026-01-04', [API_KEY])
  print('Archivos guardados:')
  for ruta in rutas:
      print(ruta)
  

Climatología

aemetdata.climatologia: Funciones para obtener datos climatológicos:

• datos_mensuales(estaciones, año_ini, año_fin, api_key): Descarga datos mensuales de climatología para una o varias estaciones.

  from aemetdata.climatologia import datos_mensuales
  resultado = await datos_mensuales(["3195","3427Y"], 2020, 2024, [API_KEY])
  import pandas as pd
  pd.DataFrame(resultado)
  

• datos_diarios(estaciones, fecha_ini, fecha_fin, api_key): Descarga datos diarios de climatología.

  from aemetdata.climatologia import datos_diarios
  resultado = await datos_diarios(["3195","3427Y"], '2022-01-01', '2022-08-10', [API_KEY])
  import pandas as pd
  pd.DataFrame(resultado)
  

• datos_normales(estaciones, api_key): Obtiene valores climatológicos normales (periodo 1991-2020).

  from aemetdata.climatologia import datos_normales
  resultado_normales = await datos_normales(["3195","3427Y"], [API_KEY])
  import pandas as pd
  pd.DataFrame(resultado_normales)
  

• datos_extremos(estaciones, api_key, parametro): Descarga valores extremos (precipitación, temperatura, viento).

  from aemetdata.climatologia import datos_extremos
  resultado_extremos_T = await datos_extremos(["3195","3427Y"], [API_KEY], parametro="T")
  import pandas as pd
  pd.DataFrame(resultado_extremos_T)
  

Imágenes

aemetdata.imagenes: Funciones para descargar imágenes meteorológicas (satélite, radar, etc.).

Observaciones

aemetdata.observaciones: Funciones para obtener observaciones meteorológicas en tiempo real.