rOpenSpain / climaemet

R Climate AEMET Tools
https://ropenspain.github.io/climaemet/
GNU General Public License v3.0
41 stars 2 forks source link

How to get metadata? #39

Closed dieghernan closed 1 year ago

dieghernan commented 1 year ago
  1. We call the function with verbose = TRUE
library(climaemet)

# Get data
obs <- aemet_monthly_clim(station = c("9434"), year = 2000, verbose = TRUE)
## 
## Requesting https://opendata.aemet.es/opendata/api/valores/climatologicos/mensualesanuales/datos/anioini/2000/aniofin/2000/estacion/9434

## OK (HTTP 200).
## -----Requesting data-----
## Requesting https://opendata.aemet.es/opendata/sh/0d4dacf2
## Remaining requests: 148
## OK (HTTP 200).Se han encontrado 13 climatologias
  1. Based on the information, we select the API endpoint and we use get_metadata_aemet()
# Get metadata (need the API endpoint)
meta <- get_metadata_aemet("/api/valores/climatologicos/mensualesanuales/datos/anioini/2000/aniofin/2000/estacion/9434")

That's it, if we explore the object...

dplyr::as_tibble(meta$campos)

    ## # A tibble: 49 × 5
    ##    id         descripcion                            tipo_datos requerido unidad
    ##    <chr>      <chr>                                  <chr>      <lgl>     <chr> 
    ##  1 fecha      año y mes (AAAA-X) donde X es un núme… string     TRUE      <NA>  
    ##  2 indicativo indicativo climatológico               string     TRUE      <NA>  
    ##  3 nombre     nombre (ubicación) de la estación      string     TRUE      <NA>  
    ##  4 provincia  provincia de la estación               string     TRUE      <NA>  
    ##  5 altitud    altitud de la estación en m sobre el … string     TRUE      m     
    ##  6 tm_mes     Temperatura media mensual/anual        string     FALSE     °C    
    ##  7 tm_max     Temperatura media mensual/anual de la… string     FALSE     °C    
    ##  8 tm_min     Temperatura media mensual/anual de la… string     FALSE     °C    
    ##  9 ta_max     Temperatura máxima absoluta del mes/a… string     FALSE     °C    
    ## 10 ta_min     Temperatura mínima absoluta del mes/a… string     FALSE     °C    
    ## # ℹ 39 more rows
knitr::kable(meta$campos)
id descripcion tipo_datos requerido unidad
fecha año y mes (AAAA-X) donde X es un número del 1 aa 13, indicando el mes y el valor 13 indica valor anual string TRUE NA
indicativo indicativo climatológico string TRUE NA
nombre nombre (ubicación) de la estación string TRUE NA
provincia provincia de la estación string TRUE NA
altitud altitud de la estación en m sobre el nivel del mar string TRUE m
tm_mes Temperatura media mensual/anual string FALSE °C
tm_max Temperatura media mensual/anual de las máximas string FALSE °C
tm_min Temperatura media mensual/anual de las mínimas string FALSE °C
ta_max Temperatura máxima absoluta del mes/año y fecha string FALSE °C
ta_min Temperatura mínima absoluta del mes/año y fecha string FALSE °C
ts_min Temperatura mínima mas alta del mes/año string FALSE °C
ti_max Temperatura máxima mas baja del mes/año string FALSE °C
nt_30 Nº de días de temperatura máxima mayor o igual que 30 °C string FALSE Nº de días
nt_00 Nº de días de temperatura mínima menor o igual que 0 °C número de días FALSE °C
p_mes Precipitación total mensual/anual string FALSE mm
p_max Precipitación máxima diaria del mes/año y fecha string FALSE mm (dia o fecha del año)
np_001 Nº de días de precipitación apreciable (>= 0,1 mm) en el mes/año string FALSE Nº de días
np_010 Nº de días de precipitación mayor o igual que 1 mm en el mes/año string FALSE Nº de días
np_100 Nº de días de precipitación mayor o igual que 10 mm en el mes/año string FALSE Nº de días
np_300 Nº de días de precipitación mayor o igual que 30 mm en el mes/año string FALSE Nº de días
hr Humedad relativa media mensual/anual string FALSE %
e Tensión de vapor media mensual/anual string FALSE décimas de hPa
n_llu Nº de días de lluvia en el mes/año string FALSE Nº de días
n_nie Nº de días de nieve en el mes/año string FALSE Nº de días
n_gra Nº de días de granizo en el mes/año string FALSE Nº de días
n_tor Nº de días de tormenta en el mes/año string FALSE Nº de días
n_fog Nº de días de niebla en el mes/año string FALSE Nº de días
n_des Nº de días despejados en el mes/año string FALSE Nº de días
n_nub Nº de días nubosos en el mes/año string FALSE Nº de días
n_cub Nº de días cubiertos en el mes/año string FALSE Nº de días
inso Media mensual/anual de la insolación diaria string FALSE horas
p_sol Porcentaje medio mensual de la insolación diaria frente a la insolación teórica string FALSE %
glo Radiación global mensual/anual string FALSE decenas de kJ/m2
evap Evaporación total mensual/anual string FALSE décimas de mm
w_rec Recorrido medio diario (de 07 a 07 UTC) del mes/año string FALSE km
w_racha Dirección, Velocidad y fecha de la racha máxima en el mes/año string FALSE Dirección en decenas de grado (99 = dirección variable)(88 = sin dato de dirección). Velocidad en m/sg
nw_55 Nº de días de velocidad del viento mayor o igual a 55 km/h en el mes/año string FALSE Nº de días
nw_91 Nº de días de velocidad del viento mayor o igual a 91 km/h en el mes/año string FALSE Nº de días
w_med Velocidad media mensual elaborada a partir de las observaciones de 07, 13 y 18 UTC string FALSE km/h
q_med Presión media mensual/anual al nivel de la estación) string FALSE hPa
q_max Presión máxima absoluta mensual/anual y fecha string FALSE hPa
q_min Presión máxima mínima mensual/anual y fecha string FALSE hPa
q_mar Presión media mensual/anual al nivel del mar string FALSE hPa
ts_10 Temperatura media mensual/anual a 10 cm de profundidad string FALSE °C
ts_20 Temperatura media mensual/anual a 20 cm string FALSE °C
ts_50 Temperatura media mensual/anual a 20 cm string FALSE °C
nv_0050 Nº de días con visibilidad inferior a 50 m en el mes/año string FALSE Nº de días
nv_0100 Nº de días con visibilidad superior o igual a 50 m e inferior a 100 m en el mes/año string FALSE Nº de días
nv_1000 Nº de días con visibilidad superior o igual a 100 m e inferior a 1 km en el mes/año string FALSE Nº de días
dieghernan commented 1 year ago

Implemented in https://ropenspain.github.io/climaemet/articles/api_metadata.html

More discussion in #40