Page tree

Diese Seite dokumentiert erweiterte Funktionen für Datenabfragen. Es empfiehlt sich zuerst die Seite API-Datenabfrage zu lesen.

Dies ist die SDMX 2.1-REST-Anforderung für Daten:

https://<api_base_uri>/sdmx/2.1/<resource>/<flowRef>/<key>?<parameters>

In jedem Abschnitt dieser Seite werden die Filter erläutert, die in dieser Syntaxdefinition festgelegt werden können.

SDMX 2.1 - REST - Datenfilterung auf Dimension

Anfordern
https://<api_base_uri>/sdmx/2.1/<resource>/<flowRef>/<key>

Der Schlüssel ist als eine Punkt ('.') Getrennte Liste von dimensionsgefilterten Werten aufgebaut.

Um den Schlüssel zu erstellen:

  • Rufen Sie die Liste Liste der Datenflüsse ab, um einen relevanten Datenfluss zu ermitteln.

  • Dann laden Sie die Datenstruktur mit Referenzen Auflösung für Kinder für den relevanten Datenfluss und überprüfen Sie die Liste der Dimensionen.

  • Jede Dimension unterstützt Werte, die von der Codelistendefinition festgelegt wurden.

  • Zum Beispiel listet die Datenstrukturdefinition für NAMA_10_GDP 4 Dimensionen in dieser Reihenfolge auf:

    • FREQ mit Werten, die durch die Codeliste FREQ festgelegt wurden

    • UNIT mit Werten, die in der Codeliste UNIT festgelegt sind

    • INDIC_NA mit Werten, die durch die Codeliste INDIC_NA festgelegt wurden

    • GEO mit Werten, die durch die Codeliste GEO festgelegt wurden

  • Für NAMA_10_GDP kann der Schlüssel [FREQ].[UNIT].[INDIC_NA].[GEO] in der exakten Reihenfolge der durch die Datenstrukturdefinition festgelegten Dimensionen zum Beispiel A.CP_MEUR.B1GQQ.LU, wobei:

Position

1

2

3

4

Abmessungen

FREQ

UNIT

INDIC_NA

GEO

Key Schlüsselwert

A

CP_MEUR

B1GQ

LU

Bedeutung

Daten aggregiert jährlich

Aktuelle Preise, Millionen Euro

Bruttoinlandsprodukt zu Marktpreisen

Luxemburg

Dimensionen, die nicht gefiltert werden sollen, bleiben in der Abfrage leer. Für NAMA_10_GDP kann der Schlüssel ohne Filter für die Dimension FREQ .CP_MEUR.B1GQ.LU sein.

Die logische Konjunktion wird mit dem Pluszeichen "+" erstellt. Für NAMA_10_GDP kann der Schlüssel A.CP_MEUR.B1GQ.BE+LU sein.

SDMX 2.1 - REST - Datenfilterung pünktlich

Dies ermöglicht das Filtern von Datenbeobachtungen innerhalb einer Zeitreihe am Start- und Enddatum.

Anfordern
https://<api_base_uri>/sdmx/2.1/<resource>/<flowRef>/<key>?startPeriod=value&endPeriod=value

Der Beginn und das Ende des Zeitraums im Filter werden als startPeriod und endPeriod festgelegt. Folgende Zeiträume werden unterstützt:

In der folgenden Tabelle steht "YYYY" für das Kalenderjahr, dargestellt in 4 Ziffern. Beispiel: 2018

ZeitraumFormat

Jährlich

YYYY-A1 oder YYYY

Semester

YYYY-S[1-2]

Viertel

YYYY-Q[1-4]

Monatlich

YYYY-M[01-12] oder JJJJ-[01-12]

Wöchentlich

YYYY-W[01-53]

Täglich

YYYY-D[001-366]

Jahresintervall

YYYY / P[01-99] Y

wie dargestellt durch

Filterung der jährlichen Beobachtungen von NAMA_10_GDP von 2012 bis 2015
https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/NAMA_10_GDP?startPeriod=2012&endPeriod=2015 
Dieselbe Kombination mit der Dimensionsschlüsselfilterung
https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/NAMA_10_GDP/A.CP_MEUR.B1GQ.LU?startPeriod=2012&endPeriod=2015 
Filtern von NAMQ_10_GDP vierteljährlichen Beobachtungen von 2015 Q2 bis 2015 Q3, kombiniert mit Dimension Key Filtering
https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/NAMQ_10_GDP/Q.CP_MEUR.SCA.B1GQ.LU?startPeriod=2015-Q2&endPeriod=2016-Q2 
Filtern nach monatlichen IRT_EURYLD_M-Beobachtungen von Monat 2015 bis Monat 06, kombiniert mit Dimension Key Filtering
https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/IRT_EURYLD_M/M.YCIF_RT.Y17.GBA_AAA.EA?startPeriod=2015-02&endPeriod=2016-06 

SDMX 2.1 - REST - Datenfilterung bei ersten N und letzten N Beobachtungen

Dies ermöglicht das Filtern von Datenbeobachtungen innerhalb einer Zeitreihe, um die Anzahl der zurückgegebenen Beobachtungen zu begrenzen.

Anfordern
https://<api_base_uri>/sdmx/2.1/<resource>/<flowRef>/<key>?firstNObservations=<value>&lastNObservations=<value>

  1. Dieser Filter kann auf Daten angewendet werden, die nach Dimension und / oder Zeit gefiltert wurden.

  2. Erste N Beobachtungen geben die ersten N Beobachtungen in der entsprechenden Serie zurück

  3. Letzte N Beobachtungen geben die letzten N Beobachtungen in der entsprechenden Serie zurück

  4. Beide Definitionen können z.B. um die erste und letzte Beobachtung in einer Serie zurückzugeben.

  5. Wenn der Filter falsch ist, wird eine Antwort ohne Beobachtungsergebnisse zurückgegeben.

Filtern auf NAMA_10_GDP für die letzten 5 jährlichen Beobachtungen
https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/NAMA_10_GDP?lastNObservations=5
Filtern auf NAMA_10_GDP für die ersten 5 jährlichen Beobachtungen
https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/NAMA_10_GDP?firstNObservations=5
Filtern auf NAMA_10_GDP für die ersten 5 und letzten 5 jährlichen Beobachtungen
https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/NAMA_10_GDP?firstNObservations=5&lastNObservations=5
Filtern auf NAMA_10_GDP für die letzten 5 jährlichen Beobachtungen, kombiniert mit Dimension Key Filtering
https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/NAMA_10_GDP/.CP_MEUR.B1GQ.LU?lastNObservations=5

SDMX 2.1 - REST - Daten Details

Anfordern
https://<api_base_uri>/sdmx/2.1/<resource>/<flowRef>/<key>?details=value

wie dargestellt durch

SDMX 2.1 - REST - Datenfilterung basierend auf der NUTS-Klassifikation


(warning) Diese Funktionalität ist noch nicht verfügbar.

Die Filterung auf NUTS-Ebene kann für regionale Datensätze durchgeführt werden. Datensätze mit Codewerten, die in der GEO-Dimension länger als 2 sind.

Wenn der Filter auf nicht regionale Datensätze angewendet wird, enthält die Abfrageantwort alle Werte in der GEO-Dimension mit Ausnahme der Länder.

Dies ermöglicht das Filtern nach GEO-Dimensionen basierend auf NUTS-2016-Klassifikation auf verschiedenen Ebenen. Weitere Informationen finden Sie auf dieser Seite.

Anfordern
https://<api_base_uri>/sdmx/2.1/<resource>/<flowRef>/<key>?geoLevel=nuts_level

_