Statistisk sentralbyr奪 sitt API mot Statistikkbanken. Presentasjon p奪 Difi sitt Datadelingsforum 31. august 2016. Streamet Video ligger p奪 http://kartverket.23video.com/ssbs-api-mot-statistikkbanken
1 of 17
Download to read offline
More Related Content
SSBs API mot Statistikkbanken
1. Jan Bruusgaard
Seksjon web og Statistikkbank
Difi Datadelingsforum / #hack4no 31.8.20161
SSBs API mot Statistikkbanken
2. ssb.no/api
API mot SSBs 束skattkiste損
Statistikkbanken.
Statistikkbanken har
Mer enn en milliard tall
Fordelt p奪 5000 tabeller
Av dette 456 tabeller p奪 kommuneniv奪
Oppdateres (nesten) hver dag
Tall tilbake til 1769
3. Hva kan en bruke SSBs API til
SSB API3
hente data automatisk inn i:
Tekst
Figur / visualisering
Tabell
Webapplikasjon
Database
Analyseverkt淡y
SAS, R etc.
4. SSB har 2 API-er
SSB API4
Ferdige datasett (lansert juni 2013)
Lag egne datasett (kom mai 2016)
5. API: Ferdige datasett
SSB API
5
SSB lager datasettet
Kun 250 datasett
Dekker mest etterspurte tabeller
Fordel: SSB holder oversikt over endringene
Egen adresse (URL) til hvert datasett
http GET
Utformat
JSON-Stat
CSV
6. API: Lag egne datasett
SSB API6
Dekker alle 5000 statistikkbanktabellene
Fleksibelt
Bruker definerer selv uttrekk
Velg st淡rrelse fra 1 til 500.000 celler
H淡yere maks. grense enn Statistikkbanken
Velger kun variabler en har behov for
7. API: Lag egne datasett
Best奪r av to deler
API: konsoll
teste og redigere sp淡rringer
API: Direkte til datasettene
http POST
Poste sp淡rring mot url
GET for 奪 traversere
7
10. Sp淡rring - filter
Item
enkeltverdier
All
Trunkering *
Bare * - velger alle
Top
Siste / 淡verste verdier
Egnet for rullerende tid
SSB API10
11. Output formater
JSON-stat (http://json-stat.org)
Anbefalt og forh奪ndsvalgt i konsoll-sp淡rring
Ferdige bibliotek for
Javascript
Java
R
Python
CSV (kommaseparert)
XLSX (Excel)
SSB API11
12. Statuskoder
200 ok
404 feil i URL eller i syntaks p奪 sp淡rringen.
403 sperre ved for stort datasett.
500 000 celler (inkl. tomme celler).
429 for mange sp淡rringer. Grensen er 30 i
minuttet
503 time-out etter 60 sekunder
SSB API12
13. Direkte til datasettene via url
http://data.ssb.no/api/v0/no/table/
JSON
{id text }
POST mot url
SSB API13
14. Kjente mangler
GET st淡ttes (forel淡pig) ikke
Metadata viser ikke aggregeringer og
grupperinger
Ingen informasjon om neste publisering
束Forel淡pige tall損 vises forskjellig eller
markeres ikke i det hele tatt
Se ogs奪 brukerveiledningen
15. Hva skjer framover
JSON-Stat 2.0
n奪 har vi versjon 1.2
Ny statistikkbank basert p奪 PX-web / KOSTRA
modernisering
videreutvikling API som del av PX-web
St淡tte for http GET
Ny datamodell
vil bl.a. ha hierarkiske variabler
KLASS ny standarddatabase med eget API
16. Ressurser
Se Brukerveiledningen nytt API for lenker
Har ogs奪 enkle eksempler p奪 sp淡rringer med POST i:
Python, R, SAS, Microsoft Power BI / Power Query
JSON-Stat
json-stat.org
Se ogs奪 json-stat.com/nsm kursmateriale og verkt淡y
Nettleser utvidelser
Jsonviewer
Poster
Curl
17. SSBs API: Oppsummert
SSB API17
Det nye API-et er best:
Mest fleksibelt
Lag egne datasett
St淡rst
5000 tabeller,
opptil 500.000 celler pr. sp淡rring
Det gamle API-et er:
Enklest
Ferdige datasett
Raskest
Begrenset
http://www.ssb.no/api
Kontakt: statistikkbanken@ssb.no (evt. jbr@ssb.no)
Editor's Notes
#3: Kort om APIet vi har hatt siden 2013, detaljert om det nye APIet og til slutt noen anbefalte ressurser for 奪 anvende det.
Alt er b奪de p奪 norsk og engelsk
#4: Bloomberg publiserer nyheter et par sekunder etter oss, oversetter minus til underskudd. Robotjournalistikk kommer, Finn tall for din kommune.
#6: Da vi kom med v奪rt beta-Api i 2013 var SSB f淡rste nasjonale statistikkbyr奪byr奪 til 奪 ta i bruk formatet JSON-stat. Det er spesielt egnet for statistikk eller mangedimensjonale datakuber.
#7: 500.000 celler inkluderer ogs奪 celler uten verdier
#8: Best奪r av alts奪 av to deler
API konsoll
Egenutviklet
API Direkte til datasettene (PX-API)
API (PX-API) f淡rste skritt mot ny Statstikkbank (PX-web)
Det aller viktigste 奪 gj淡re oppmerksom p奪 er at det nye APIet bruker protokollen http POST. Det er uvanlig. Ogs奪 for it-folk som jobber lite med web er dette ukjent.
#9: G奪 til http://www.ssb.no/omssb/tjenester-og-verktoy/api
Den enkle m奪ten 奪 bruke det nye APIet er Velg Lag egne datasett - konsoll
S淡k folkemengde ett奪rig alder nullstill tabellnummer 07459
Eksempelsp淡rring - 3 f淡rste av hver variabel - JSON
Velg Kj淡r
Vis resultatrute JSON-stat
Rediger sp淡rring 奪r 2016 - Kj淡r
Vis response endre til csv
#10: Enkel og kompakt
enkelt 奪 l脱re grunnleggende syntaks ogs奪 for ikke programmerere
Mange ferdige biblioteker
tar mer og mer over for XML
Sp淡rring innledes med {束query損
#11: Item
enkeltverdier
All
Trunkering *
Top
Siste / 淡verste verdier Egnet for tid her et et eksempel med siste 13 m奪neder for regne ut prosentvis 奪rsendring. Tid Top 1 sikrer alltid siste tall
Det finnes to filtre til for aggregeringer og grupperinger, men de vises ikke i metadata (kommer)
#12: JSON-stat tilbys n奪 av alle nordiske statistikkbyr奪er, samt Eurostat. Veldig mange norske data leveres til Eurostat som er EUs statistikkkontor. Om en vil sammenlikne Norske data med andre Europeiske land, kan det v脱re verdt 奪 sjekke
#17: JSON-stat
har ferdige biblioteker
Enkle POST eksempler
Python
R
Microsoft Power BI / Power Query
SAS
For lenker, se brukerveiledningen