API za podatkovni portal SI-STAT (Statistični urad RS)
PHP
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
LICENSE
Readme.md
composer.json
sistat.php

Readme.md

SISTAT-API

JSON API podatkovnega portala SI-STAT Staističnega urada Republike Slovenije.

About

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.

Uporaba

  1. Na spletni strani aplikacije SI-STAT poiščete področje in sklop podatkov, ki jih želite uporabiti.
  2. 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 primru 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.) Dimenzije, ki so v spletni aplikaciji označene z zvezdico, so obvezne.
  3. 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)
      • label - ime dimenzije. (ref)
      • category - objekt opisuje možne vrednosti dimenzije. (ref)
        • index - objekt vsebuje vrstni red možnih vrednosti dimenzije. (ref)
        • label - objekt vsebuje imena možnih vrednosti dimenzije. (ref)
        • note - objekt vsebuje morebitna dodatna pojasnila za posamezno vrednost dimenzije. (ref)
    • value - objekt vsebuje podatke glede na izbrane dimenzije. (ref)
    • note - polje vsebuje morebitna dodatna pojasnila o prenešenih podatkih ter kontakt. (ref)

Primer

Primer za podatke o prihodih in prenočitvah turistov po vrstah občin, po skupinah nastanitvenih objektov in po državah, Slovenija, mesečno

  1. 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/
  2. Ostale GET parametre za poizvedbo kot je prikazana na spodnji sliki zapišemo sledeče: primer izbire parametrov
    • vrste_občin=SLOVENIJA
    • skupine_nastanitvenih_objektov=all
    • države=DRŽAVE - SKUPAJ,DOMAČI,TUJI
    • mesec=last
    • meritve=Prenočitve turistov - SKUPAJ
  3. 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

Licenca

  • Podatki: potrebno je navesti vir podatkov, ki jih uporabljate (Statistični urad Republike Slovenije)
  • SISTAT-API: MIT License

Avtor

Žiga Šebenik ziga@sebenik.com