JSON API podatkovnega portala SI-STAT Staističnega urada Republike Slovenije.
Spletna aplikacija Statističnega urada Republike Slovenije SI-STAT, ki je razdeljena po tematskih področjih, omogoča iskanje in prenos objavljenih statističnih podatkov. Te je mogoče prikazati v tabeli ali prenesti v obliki različnih datotek (txt, csv, px, xls, htm). SISTAT-API po zgledu Eurostat-a, omogoča prenos podatkov preko spletne aplikacije SI-STAT v JSON-STAT formatu. Več o formatu najdete na tej povezavi: https://json-stat.org.
- Na spletni strani aplikacije SI-STAT poiščete področje in sklop podatkov, ki jih želite uporabiti.
- Sestavite API klic:
- URL - http://sistat.sebenik.com/
- GET parametri:
- ma - parameter, katerega vrednost najdete v spletnem naslovu izbranega sklopa podatkov (obvezen parameter)
- path - parameter, katerega vrednost najdete v spletnem naslovu izbranega sklopa podatkov (obvezen parameter)
- dimenzija* - parametri s katerimi označimo izbrane dimenzije in vrednosti v tabelah. Ime parametra pišemo z malimi črkami, presledke pa nadomestimo s podčrtajem '_'. Vrednosti posameznega parametra pišemo kakor so prikazane v tabelah na spletni strani. V primeru izbire večjega števila vrednosti posamezne dimenzije, le te ločimo z vejico ','. Če želimo izbrati vse vrednosti posamezne dimenzije lahko namesto naševanja vseh, za vrednost dimenzije napišemo 'all', če želimo izbrati zgolj prvo vrednost dimenzije lahko napišemo 'first' ali 'last', če želimo izbrati zgolj zadnjo vrednost dimenzije. (Glej primer.) Za izbor niza zadnjih vrednosti za dimenzijo napišemo 'lastN', kjer N označuje izbrano dolžino niza, na primer 'last10' za zadnjih deset. Dimenzije, ki so v spletni aplikaciji označene z zvezdico, so obvezne.
- Struktura odgovora je v JSON-STAT formatu. Vsebuje naslednja polja:
- version - označuje vezijo JSON-STAT formata (ref)
- class - označuje razred odgovora. Odgovor SISTAT-API-ja je vedno razreda 'dataset'. (ref)
- title - naslov tabele oz. sklopa prenešenih podatkov.
- description - opis tabele oz. sklopa prenešenih podatkov.
- contents - področje (nadskupina) sklopa prenešenih podatkov.
- created - označuje čas generiranja podatkov 'leto/mesec/dan ura'.
- updated - označuje čas posodobitve podatkov 'leto/mesec/dan ura'.
- source - vir podatkov.
- href - spletni naslov do spletne aplikacije za konkretni sklop prenešenih podatkov.
- id - polje vsebuje oznake izbranih dimenzij. (ref)
- size - polje vsebuje število izbranih vrednosti za posamezno dimenzijo. Zaporedje je enako kot v polju 'id'. (ref)
- dimension - objekt vsebuje informacije o posamezni izbrani dimenziji. (ref)
- value - objekt vsebuje podatke glede na izbrane dimenzije. (ref)
- note - polje vsebuje morebitna dodatna pojasnila o prenešenih podatkih ter kontakt. (ref)
Primer za podatke o prihodih in prenočitvah turistov po vrstah občin, po skupinah nastanitvenih objektov in po državah, Slovenija, mesečno
- Iz spletnega naslova za izbran sklop podatkov http://pxweb.stat.si/pxweb/Dialog/varval.asp?ma=2164407S&ti=&path=../Database/Ekonomsko/21_gostinstvo_turizem/01_21644_nastanitev_mesecno/&lang=2 prekopiramo GET parametra ma in path.
- ma=2164407S
- path=../Database/Ekonomsko/21_gostinstvo_turizem/01_21644_nastanitev_mesecno/
- Ostale GET parametre za poizvedbo kot je prikazana na spodnji sliki zapišemo sledeče:
- vrste_občin=SLOVENIJA
- skupine_nastanitvenih_objektov=all
- države=DRŽAVE - SKUPAJ,DOMAČI,TUJI
- mesec=last
- meritve=Prenočitve turistov - SKUPAJ
- Celoten GET request izgleda tako: http://sistat.sebenik.com/?ma=2164407S&path=../Database/Ekonomsko/21_gostinstvo_turizem/01_21644_nastanitev_mesecno/&vrste_ob%C4%8Din=SLOVENIJA&skupine_nastanitvenih_objektov=all&dr%C5%BEave=DR%C5%BDAVE%20-%20SKUPAJ,DOMA%C4%8CI,TUJI&mesec=last&meritve=Preno%C4%8Ditve%20turistov%20-+SKUPAJ
- Podatki: potrebno je navesti vir podatkov, ki jih uporabljate (Statistični urad Republike Slovenije)
- SISTAT-API: MIT License
Žiga Šebenik ziga@sebenik.com