Librerie e API
Tutte le opzioni seguenti leggono gli stessi file pubblicati, quindi i numeri sono identici qualunque si usi.
API JSON
Un'API HTTP di sola lettura all'indirizzo https://dataseries.org. Non serve alcuna chiave.
| Endpoint | Restituisce |
|---|---|
GET /catalog | l'elenco completo dei set di dati (id, titolo, fonte, licenza, frequenza, periodo coperto, ultimo aggiornamento) |
GET /dataset/{id}/meta | i metadati di un set di dati: dimensioni, modalità, etichette, unità, gerarchia |
GET /series?dataset={id}&dims={spec}&from={date}&to={date} | le serie selezionate in JSON per colonne |
GET /series.csv?dataset={id}&dims={spec}&from={date}&to={date} | la stessa selezione in CSV in formato lungo (una riga per osservazione), leggibile da qualsiasi strumento in grado di aprire un URL CSV |
GET /health | lo stato del servizio |
dims seleziona le modalità all'interno di ogni dimensione, separate da punti e virgola, ad esempio structure=gdp;type=nom;seas_adj=csa. Senza dims si ottiene l'intero set di dati. from e to sono date ISO facoltative.
# Whole catalog curl https://dataseries.org/catalog # SECO GDP, nominal, seasonally adjusted, from 2000 curl "https://dataseries.org/series?dataset=ch_seco_gdp&dims=structure=gdp;type=nom;seas_adj=csa&from=2000-01-01" # A single-series dataset curl "https://dataseries.org/series?dataset=ch_kof_barometer"
Gli endpoint sono documentati in /__docs__/, dove è anche possibile provarli. La specifica OpenAPI si trova in /openapi.json.
R
ds() accetta l'id di un set di dati e un argomento per dimensione, e restituisce un data frame con una colonna Date. ds_catalog() elenca i set di dati, ds_meta() mostra le dimensioni e i codici di un set di dati e ds_search() trova singole serie.
install.packages("dataseries")
library(dataseries)
# SECO GDP, nominal, seasonally adjusted, from 2000
df <- ds("ch_seco_gdp", structure = "gdp", type = "nom", seas_adj = "csa",
from = "2000-01-01")
# A single-series dataset: no dimension arguments
df <- ds("ch_kof_barometer")Python
Il pacchetto Python offre le stesse funzioni del pacchetto R e restituisce DataFrame pandas. Gli argomenti per le date si chiamano start ed end invece di from e to.
pip install dataseries
from dataseries import ds
# SECO GDP, nominal, seasonally adjusted, from 2000
df = ds("ch_seco_gdp", structure="gdp", type="nom", seas_adj="csa",
start="2000-01-01")
# A single-series dataset: no dimension arguments
df = ds("ch_kof_barometer")Altri software
/series.csv restituisce un file CSV, quindi qualsiasi strumento in grado di aprire un URL può leggere direttamente una serie, con gli stessi filtri dims, from e to. Il riquadro Usa questa serie in ogni pagina di set di dati genera il codice per la selezione corrente.
# Stata
import delimited "https://dataseries.org/series.csv?dataset=ch_seco_gdp&dims=structure=gdp;type=nom;seas_adj=csa", clear
# MATLAB
T = readtable("https://dataseries.org/series.csv?dataset=ch_kof_barometer");
# Julia
using CSV, DataFrames, Downloads
df = CSV.read(Downloads.download("https://dataseries.org/series.csv?dataset=ch_kof_barometer"), DataFrame)
# Excel / Power Query: Data > Get Data > From Web, then paste the URL (refreshes in place)
https://dataseries.org/series.csv?dataset=ch_kof_barometer
# SAS
filename ds url "https://dataseries.org/series.csv?dataset=ch_kof_barometer";
proc import file=ds out=work.ds dbms=csv replace; run;
# curl / shell
curl "https://dataseries.org/series.csv?dataset=ch_kof_barometer"Download
Ogni pagina di set di dati permette di scaricare la selezione corrente, con l'eventuale trasformazione applicata, in CSV, Excel o JSON, e il grafico in PNG o SVG. I file completi di ogni set di dati (dati CSV, metadati JSON e una copia Parquet) si trovano nel repository dataseries-data.
Incorporare i grafici
I grafici possono essere incorporati in qualsiasi pagina web con un iframe. La scheda Incorpora del riquadro Usa questa serie genera il codice per la selezione corrente. I grafici incorporati si aggiornano non appena arrivano nuovi dati.
<iframe src="https://dataseries.org/d/ch_kof_barometer?embed=1" width="100%" height="580" style="border:0;border-radius:12px" loading="lazy" title="KOF Barometer, dataseries.org"> </iframe>