際際滷

際際滷Share a Scribd company logo
Jan Bruusgaard
Seksjon web og Statistikkbank
statistikkbanken@ssb.no
Api-kurs september 20171
SSBs API mot Statistikkbanken
www.ssb.no/api
 Innhold i kurset
 Generell oversikt over SSBs API.
 Demonstrasjon av API: Ferdige datasett
 Demonstrasjon av API-konsoll
 Lage egne sp淡rringer i API konsoll (oppgaver)
 Bruke API for 奪 s淡ke tabeller i Statistikkbanken
 Ressurser for 奪 bruke APIet
Statistikkbanken
 Mer enn en milliard tall
 Fordelt p奪 5000 tabeller
 Av dette rundt 470 tabeller p奪 kommuneniv奪
 Tall tilbake til 1769
 Oppdateres (nesten) hver dag
 Tips: Snarvei til tabeller
 www.ssb.no/tabell/kortnavn
 www.ssb.no/tabell/kpi (alle KPI i Statistikkbanken)
 www.ssb.no/tabell/ 5 sifret tabell nummer
 www.ssb.no/tabell/07459
www.ssb.no/en/table/03013 (engelsk)
 Introduksjon video (2:55)
Hva kan en bruke SSBs API til
SSB API4
 hente data/statistikk automatisk inn i:
 Tekst
 Figur / visualisering
 Tabell
 Webapplikasjon f.eks. http://www.ssb.no/kommunefakta/oslo
 Database
 Analyseverkt淡y
 SAS, R etc.
Eksempel: Bloomberg
5
 Bloomberg sender denne nyheten:
 NORWAY MARCH TRADE SURPLUS NK9.1 BLN
 Den kan deles i to
 Mal
 Data
 NORWAY MARCH TRADE SURPLUS NK9.1 BLN
 Hvordan kan de lage denne kl. 08.00.02?
9 068Ikke 2016M03
Hva betyr API
6
 API: Application Programming Interface
Grensesnitt for programmering
mot en applikasjon
 Applikasjonen er Statistikkbanken
 Web API betyr web grensesnitt mot API,
benytter http - hypertext transfer protocol
 Programmere uttrekk fra banken via web
 Kan arbeide p奪 dataelement-niv奪 uten at det m奪
opprettes lokale kopier
SSB har 2 API-er
SSB API7
 Ferdige datasett (lansert juni 2013)
 Lag egne datasett (kom mai 2016)
API er for v奪re storbrukere
API: Lag egne datasett (POST)
API: Ferdige datasett (GET)
Mitt SSB - lagret s淡k mot Statistikkbanken
Statistikkbanken
Statistikk med ferdigtabeller
N淡kkeltall
API: Ferdige datasett
SSB API
9
 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
API: Lag egne datasett
SSB API10
 Dekker alle 5 000
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
API: Lag egne datasett
 Best奪r av to deler
 API: konsoll
 teste og redigere sp淡rringer
 API: Direkte til datasettene (PX-API)
 http POST
 Poste sp淡rring mot url
 GET for 奪 traversere
11
SSBs API mot Statistikkbanken
Sp淡rringer
 Formuleres i JSON-format
 Enkel og kompakt
 enkelt 奪 l脱re grunnleggende syntaks
 POSTes mot URL
JSON  hva er det?
 JSON
 JavaScript Object Notation
 Har ingenting med Java 奪 gj淡re og er etter hvert uavhengig av JavaScript
 Lettvekts tekst format for datautveksling
 Enklere og erstatter mer og mer XML
 Relativt lett 奪 lese for mennesker
 Maskiner kan lett analysere og generere JSON
 {}
14
Sp淡rring - filter
 3 filtre: item, all, top
 Item
 enkeltverdier
 All
 Trunkering *
 Bare * - velger alle
 Top
 Siste / 淡verste verdier
 Egnet for rullerende tid
SSB API15
JSON struktur
Fordi teorien er litt vanskelig for ikke-programmerere, lagde vi konsollen
 Samling av navn/verdi par
 Objekt { medlemmer }
 Kan n淡stes
 Ordnet liste med verdier
 Array [ elementer ]
 Navn/verdi par
 Streng : verdi
 "filter" : "item"
16
API Output formater
 JSON-stat (http://json-stat.org)
 Anbefalt og forh奪ndsvalgt i konsoll-sp淡rring
 egnet for statistikk - datasett i mange dimensjoner
 Ferdige bibliotek for
 Javascript
 Java
 R
 Python
 CSV (kommaseparert)
 XLSX (Excel)
SSB API17
Statuskoder
 Statuskoder fra API gis n奪r en henter datasett
 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 API18
Metadata-fanen
19
Tips:
1. Prettyfy JSON
2. Klipp deler herfra og
lim inn i sp淡rring
Alternativ: Lag sp淡rring med filter all *
response xlsx/json-stat. Bruk
kodene her til 奪 lage ny sp淡rring.
Oppgave - konsoll
20
 Start Firefox eller Chrome.
 Hent opp tabell 07459 i konsoll. Trykk Kj淡r.
 Endre sp淡rring til 奪
1. Ta ut dataene i Excel. Se p奪 kodene.
2. Ta kun ut antall 0-奪ringer (000) begge kj淡nn i Halden (0101)
3. Begrense uttrekk til perioden 2010 - 2017.
 Det er flere m奪ter 奪 gj淡re dette. Pr淡v 奪 bruke filtrene:
 Item
 All
 Top
 Hvorden vil disse virke i mars 2018.
 Trykk 束Kj淡r損 mellom hvert av punktene
Oppgave 2 - konsoll
21
 Fortsett med tabell 07459 i konsoll. Endre
sp淡rring til 奪
1. Ta ut antall 100-奪ringer i Halden (0101) og Oslo
(0301) i 2017 som csv
2. Endre til totalt antall innbyggere Oslo og Halden
som Excel
 Tips: Alder har elimination: true
3. Totalt antall innbyggere i Akershus fylke (02) og
alle kommuner i Akershus
 Tips: filter all
 Trykk 束Kj淡r損 mellom hvert av punktene
Lage et eget enkelt datasett i API?
22
 Velg API konsoll
 http://data.ssb.no/api/v0/no/console


S淡k f.eks tabell 07459
 Be om Excel som utformat:
 I helt nederst i ruten for Sp淡rring, rediger :
"format": "json-stat"
 Slik:
"format": "xlsx"
 Trykk p奪 knappen:
API sp淡rre etter perioden 2010-2017
Svar oppgave 123
Tre Alternativer
1. {
"code": "Tid",
"selection": {
"filter": "item",
"values": ["2010", "2011", "2012", "2013", "2014", "2015", "2016", "2017"]
}
}
2. "selection": {
"filter": "all",
"values": [ "201*" ]
3. "selection": {
"filter": "top",
"values": [ "8" ]
}
Hva skjer framover
 Ny Statistikkbank basert p奪 PX-web / KOSTRA
modernisering
 Lansering vinter 2018 (9. januar?)
 Mulig 奪 f奪 API-kode til sp淡rringer direkte fra
Statistikkbanken
 videreutvikling PX-API som del av PX-web
 GET URL'er
 Annet
 JSON-stat 2.0
 n奪 har vi versjon 1.2
Kjente mangler
 束Forel淡pige tall損 vises forskjellig eller markeres ikke i
det hele tatt
 Grense p奪 500.000 celler, inkl tomme celler
 Statistikkvariabeltekst vises i hode sammen med tid i
CSV
 Metadata viser ikke aggregeringer og grupperinger.
Kommer i 2018?
 http GET st淡ttes ikke. GET url-er kommer 2018?
 D奪rlig informasjon om neste publisering og
oppdatering
Hvordan f奪 informasjon om publisering?
 Statistikkkalenderen
http://www.ssb.no/kalender
 RSS-feeden for kommende publiseringer
http://www.ssb.no/rss/kalender
 Abonnere p奪 nyhetsbrev: Mitt SSB
 RSS: sist oppdaterte tabeller i Statikkbanken
for et kortnavn
http://www.ssb.no/rss/statbank/kortnavn
 Den enkelte statistikkside
26
Ressurser
 Se Brukerveiledningen nytt API for lenker
 JSON-stat
 json-stat.org
 Se ogs奪 json-stat.com/nsm  kursmateriale og verkt淡y
 JSON-stat Conversion Tools (command line interface) bl.a.
egnet for 奪 lage fleksibel CSV.
 Nettleser
 Ikke bruk Internet Explorer.
 anbefalte utvidelser
 Jsonviewer
 Poster
Kodeeksempler
 Se www.ssb.no/omssb/tjenester-og-verktoy/api/px-api/eksempler-pa-kode
for enkle kodeeksempler:
 JSON-sp淡rring etter begrenset til dagens 426 kommuner
(Kommuner2017)
 Sp淡rringer i R
 Sp淡rringer i SAS
 Sp淡rring med Python
 Datadrevne figurer I Highcharts
 Microsoft Excel 2016/PowerBI/Powerquery
 Lenker til andre ressurser
28
Bloomberg forts.
29
 Hvilket API er raskest?
My question is if your data will be provided on the new interface
any faster than on the old API feed. I am thinking of terms of
seconds, or even, milliseconds.
 APIet med ferdige datasett er raskest
 Varnish cache
 2-10 sekunder for f淡rste sp淡rring etter kl. 8
avhengig av st淡rrelse p奪 datasettet.
API: Direkte til datasettene  via url

http://data.ssb.no/api/v0/no/table/
 Traversere
emnestruktur
 emne > underemne
> statistikk (kortnavn)
> tabell (POST url)
 Snarvei: legg til
tabellnr. etter table
i url
SSB API30
S淡k API med URL
 Innledes med: ?query=
 s淡ker ogs奪 variabler
 S淡k med Tabellid for 奪 finne tabellnummer:
http://data.ssb.no/api/v0/no/table/?query=folkframt6
 S淡k bolig begrenset til tittelfelt
http://data.ssb.no/api/v0/no/table/?query=title:bolig
 S淡k etter alder, begrenset til emnet transport
http://data.ssb.no/api/v0/no/table/tr?query=alder
31
S淡k API med URL, forts.
 space gir AND
 Tegnene ?(  )=() i url gir parametre, flere
parametre kombineres med &
 ssb.no (ikke API) KOSTRA eksempel :
http://www.ssb.no/sok?innholdstype=statistikkbanktabell&sok="funksjon 170"
 http://data.ssb.no/api/v0/no/table/?query=funksjon AND 170
 Begrense til ett felt med feltnavn og kolon
?query=title:indeks
 husk at en del tabeller er p奪 nynorsk
 Se flere eksempler i Brukerveiledningen
32
Oppgave 3 - s淡k
33
 Naviger i datastrukturen
http://data.ssb.no/api/v0/no/table/
ned til tabellen "Totalkostnadsindeksar for
lastebiltransport"
 Tips: Finn den evt. f淡rst i strukturen p奪 ssb.no
 Finn statstikker under kriminalitet som har
variabelen statsborgerskap
SSBs API: Oppsummert
SSB API34
 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, men ingen Kostra-datasett
 Raskest
 Begrenset
 http://www.ssb.no/api
 Kontakt: statistikkbanken@ssb.no (evt. jbr@ssb.no)
Anbefalte nettleser tillegg
35
 Jsonviewer
 Firefox:
https://addons.mozilla.org/en-us/firefox/addon/jsonview/
 Chrome(ium):
https://chrome.google.com/webstore/detail/json-viewer/gbmdgpbipfallnflgajpaliibnhdgobh
cURL
 cURL  web fra kommandolinjen
 Egnet for 奪 overf淡re data raskt
 egnet for API-bruk
 cURL er allerede installert p奪 Linux
 cURL er mulig 奪 installere p奪 Windows
 Bruke cmd.exe eller powershell
 P奪 Windows m奪 alle  erstattes med 
36
cURL
 lagre sp淡rring fra API-konsoll
filen sp1.json p奪 hjemmeomr奪det p奪 linux
 kj淡r cURL slik fra kommandolinjen:
 -d input
 @ les input (sp淡rring) fra fil
 -X POST bruk http post
 -o skriv til outputfil
37
Tillegg
38
 For de som er vil ha mer
Klass API
 SSBs tjeneste for Klassifikasjoner og
kodelister
 https://www.ssb.no/klass
 KLASS API guide
 Alle eksempler i Klass API benytter cURL
 Source code on Github
http://github.com/statisticsnorway/klass
39
JSON-stat conv
 JSON-stat Conversion Tools
 https://github.com/badosa/JSON-stat-conv
 Forutsetter node.js installert
 Fleksible konverteringsverkt淡y
 jsonstat2csv - converts JSON-stat into CSV
 jsonstat2array - converts JSON-stat into an array of arrays
 jsonstat2arrobj - converts JSON-stat into an array of objects
 jsonstat2object - converts JSON-stat into an object
40
Enkelt R-eksempel med ferdig datasett
41
R: Lag eget datasett (POST) eksempel
 Se ogs奪 MyRland http://www.myrland.one
http://www.myrland.one/2016/06/07/ssbs-api-for-a-laste-ned-bensin-og-dieseldata/
42

More Related Content

SSBs API mot Statistikkbanken

  • 1. Jan Bruusgaard Seksjon web og Statistikkbank statistikkbanken@ssb.no Api-kurs september 20171 SSBs API mot Statistikkbanken
  • 2. www.ssb.no/api Innhold i kurset Generell oversikt over SSBs API. Demonstrasjon av API: Ferdige datasett Demonstrasjon av API-konsoll Lage egne sp淡rringer i API konsoll (oppgaver) Bruke API for 奪 s淡ke tabeller i Statistikkbanken Ressurser for 奪 bruke APIet
  • 3. Statistikkbanken Mer enn en milliard tall Fordelt p奪 5000 tabeller Av dette rundt 470 tabeller p奪 kommuneniv奪 Tall tilbake til 1769 Oppdateres (nesten) hver dag Tips: Snarvei til tabeller www.ssb.no/tabell/kortnavn www.ssb.no/tabell/kpi (alle KPI i Statistikkbanken) www.ssb.no/tabell/ 5 sifret tabell nummer www.ssb.no/tabell/07459 www.ssb.no/en/table/03013 (engelsk) Introduksjon video (2:55)
  • 4. Hva kan en bruke SSBs API til SSB API4 hente data/statistikk automatisk inn i: Tekst Figur / visualisering Tabell Webapplikasjon f.eks. http://www.ssb.no/kommunefakta/oslo Database Analyseverkt淡y SAS, R etc.
  • 5. Eksempel: Bloomberg 5 Bloomberg sender denne nyheten: NORWAY MARCH TRADE SURPLUS NK9.1 BLN Den kan deles i to Mal Data NORWAY MARCH TRADE SURPLUS NK9.1 BLN Hvordan kan de lage denne kl. 08.00.02? 9 068Ikke 2016M03
  • 6. Hva betyr API 6 API: Application Programming Interface Grensesnitt for programmering mot en applikasjon Applikasjonen er Statistikkbanken Web API betyr web grensesnitt mot API, benytter http - hypertext transfer protocol Programmere uttrekk fra banken via web Kan arbeide p奪 dataelement-niv奪 uten at det m奪 opprettes lokale kopier
  • 7. SSB har 2 API-er SSB API7 Ferdige datasett (lansert juni 2013) Lag egne datasett (kom mai 2016)
  • 8. API er for v奪re storbrukere API: Lag egne datasett (POST) API: Ferdige datasett (GET) Mitt SSB - lagret s淡k mot Statistikkbanken Statistikkbanken Statistikk med ferdigtabeller N淡kkeltall
  • 9. API: Ferdige datasett SSB API 9 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
  • 10. API: Lag egne datasett SSB API10 Dekker alle 5 000 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
  • 11. API: Lag egne datasett Best奪r av to deler API: konsoll teste og redigere sp淡rringer API: Direkte til datasettene (PX-API) http POST Poste sp淡rring mot url GET for 奪 traversere 11
  • 13. Sp淡rringer Formuleres i JSON-format Enkel og kompakt enkelt 奪 l脱re grunnleggende syntaks POSTes mot URL
  • 14. JSON hva er det? JSON JavaScript Object Notation Har ingenting med Java 奪 gj淡re og er etter hvert uavhengig av JavaScript Lettvekts tekst format for datautveksling Enklere og erstatter mer og mer XML Relativt lett 奪 lese for mennesker Maskiner kan lett analysere og generere JSON {} 14
  • 15. Sp淡rring - filter 3 filtre: item, all, top Item enkeltverdier All Trunkering * Bare * - velger alle Top Siste / 淡verste verdier Egnet for rullerende tid SSB API15
  • 16. JSON struktur Fordi teorien er litt vanskelig for ikke-programmerere, lagde vi konsollen Samling av navn/verdi par Objekt { medlemmer } Kan n淡stes Ordnet liste med verdier Array [ elementer ] Navn/verdi par Streng : verdi "filter" : "item" 16
  • 17. API Output formater JSON-stat (http://json-stat.org) Anbefalt og forh奪ndsvalgt i konsoll-sp淡rring egnet for statistikk - datasett i mange dimensjoner Ferdige bibliotek for Javascript Java R Python CSV (kommaseparert) XLSX (Excel) SSB API17
  • 18. Statuskoder Statuskoder fra API gis n奪r en henter datasett 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 API18
  • 19. Metadata-fanen 19 Tips: 1. Prettyfy JSON 2. Klipp deler herfra og lim inn i sp淡rring Alternativ: Lag sp淡rring med filter all * response xlsx/json-stat. Bruk kodene her til 奪 lage ny sp淡rring.
  • 20. Oppgave - konsoll 20 Start Firefox eller Chrome. Hent opp tabell 07459 i konsoll. Trykk Kj淡r. Endre sp淡rring til 奪 1. Ta ut dataene i Excel. Se p奪 kodene. 2. Ta kun ut antall 0-奪ringer (000) begge kj淡nn i Halden (0101) 3. Begrense uttrekk til perioden 2010 - 2017. Det er flere m奪ter 奪 gj淡re dette. Pr淡v 奪 bruke filtrene: Item All Top Hvorden vil disse virke i mars 2018. Trykk 束Kj淡r損 mellom hvert av punktene
  • 21. Oppgave 2 - konsoll 21 Fortsett med tabell 07459 i konsoll. Endre sp淡rring til 奪 1. Ta ut antall 100-奪ringer i Halden (0101) og Oslo (0301) i 2017 som csv 2. Endre til totalt antall innbyggere Oslo og Halden som Excel Tips: Alder har elimination: true 3. Totalt antall innbyggere i Akershus fylke (02) og alle kommuner i Akershus Tips: filter all Trykk 束Kj淡r損 mellom hvert av punktene
  • 22. Lage et eget enkelt datasett i API? 22 Velg API konsoll http://data.ssb.no/api/v0/no/console S淡k f.eks tabell 07459 Be om Excel som utformat: I helt nederst i ruten for Sp淡rring, rediger : "format": "json-stat" Slik: "format": "xlsx" Trykk p奪 knappen:
  • 23. API sp淡rre etter perioden 2010-2017 Svar oppgave 123 Tre Alternativer 1. { "code": "Tid", "selection": { "filter": "item", "values": ["2010", "2011", "2012", "2013", "2014", "2015", "2016", "2017"] } } 2. "selection": { "filter": "all", "values": [ "201*" ] 3. "selection": { "filter": "top", "values": [ "8" ] }
  • 24. Hva skjer framover Ny Statistikkbank basert p奪 PX-web / KOSTRA modernisering Lansering vinter 2018 (9. januar?) Mulig 奪 f奪 API-kode til sp淡rringer direkte fra Statistikkbanken videreutvikling PX-API som del av PX-web GET URL'er Annet JSON-stat 2.0 n奪 har vi versjon 1.2
  • 25. Kjente mangler 束Forel淡pige tall損 vises forskjellig eller markeres ikke i det hele tatt Grense p奪 500.000 celler, inkl tomme celler Statistikkvariabeltekst vises i hode sammen med tid i CSV Metadata viser ikke aggregeringer og grupperinger. Kommer i 2018? http GET st淡ttes ikke. GET url-er kommer 2018? D奪rlig informasjon om neste publisering og oppdatering
  • 26. Hvordan f奪 informasjon om publisering? Statistikkkalenderen http://www.ssb.no/kalender RSS-feeden for kommende publiseringer http://www.ssb.no/rss/kalender Abonnere p奪 nyhetsbrev: Mitt SSB RSS: sist oppdaterte tabeller i Statikkbanken for et kortnavn http://www.ssb.no/rss/statbank/kortnavn Den enkelte statistikkside 26
  • 27. Ressurser Se Brukerveiledningen nytt API for lenker JSON-stat json-stat.org Se ogs奪 json-stat.com/nsm kursmateriale og verkt淡y JSON-stat Conversion Tools (command line interface) bl.a. egnet for 奪 lage fleksibel CSV. Nettleser Ikke bruk Internet Explorer. anbefalte utvidelser Jsonviewer Poster
  • 28. Kodeeksempler Se www.ssb.no/omssb/tjenester-og-verktoy/api/px-api/eksempler-pa-kode for enkle kodeeksempler: JSON-sp淡rring etter begrenset til dagens 426 kommuner (Kommuner2017) Sp淡rringer i R Sp淡rringer i SAS Sp淡rring med Python Datadrevne figurer I Highcharts Microsoft Excel 2016/PowerBI/Powerquery Lenker til andre ressurser 28
  • 29. Bloomberg forts. 29 Hvilket API er raskest? My question is if your data will be provided on the new interface any faster than on the old API feed. I am thinking of terms of seconds, or even, milliseconds. APIet med ferdige datasett er raskest Varnish cache 2-10 sekunder for f淡rste sp淡rring etter kl. 8 avhengig av st淡rrelse p奪 datasettet.
  • 30. API: Direkte til datasettene via url http://data.ssb.no/api/v0/no/table/ Traversere emnestruktur emne > underemne > statistikk (kortnavn) > tabell (POST url) Snarvei: legg til tabellnr. etter table i url SSB API30
  • 31. S淡k API med URL Innledes med: ?query= s淡ker ogs奪 variabler S淡k med Tabellid for 奪 finne tabellnummer: http://data.ssb.no/api/v0/no/table/?query=folkframt6 S淡k bolig begrenset til tittelfelt http://data.ssb.no/api/v0/no/table/?query=title:bolig S淡k etter alder, begrenset til emnet transport http://data.ssb.no/api/v0/no/table/tr?query=alder 31
  • 32. S淡k API med URL, forts. space gir AND Tegnene ?( )=() i url gir parametre, flere parametre kombineres med & ssb.no (ikke API) KOSTRA eksempel : http://www.ssb.no/sok?innholdstype=statistikkbanktabell&sok="funksjon 170" http://data.ssb.no/api/v0/no/table/?query=funksjon AND 170 Begrense til ett felt med feltnavn og kolon ?query=title:indeks husk at en del tabeller er p奪 nynorsk Se flere eksempler i Brukerveiledningen 32
  • 33. Oppgave 3 - s淡k 33 Naviger i datastrukturen http://data.ssb.no/api/v0/no/table/ ned til tabellen "Totalkostnadsindeksar for lastebiltransport" Tips: Finn den evt. f淡rst i strukturen p奪 ssb.no Finn statstikker under kriminalitet som har variabelen statsborgerskap
  • 34. SSBs API: Oppsummert SSB API34 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, men ingen Kostra-datasett Raskest Begrenset http://www.ssb.no/api Kontakt: statistikkbanken@ssb.no (evt. jbr@ssb.no)
  • 35. Anbefalte nettleser tillegg 35 Jsonviewer Firefox: https://addons.mozilla.org/en-us/firefox/addon/jsonview/ Chrome(ium): https://chrome.google.com/webstore/detail/json-viewer/gbmdgpbipfallnflgajpaliibnhdgobh
  • 36. cURL cURL web fra kommandolinjen Egnet for 奪 overf淡re data raskt egnet for API-bruk cURL er allerede installert p奪 Linux cURL er mulig 奪 installere p奪 Windows Bruke cmd.exe eller powershell P奪 Windows m奪 alle erstattes med 36
  • 37. cURL lagre sp淡rring fra API-konsoll filen sp1.json p奪 hjemmeomr奪det p奪 linux kj淡r cURL slik fra kommandolinjen: -d input @ les input (sp淡rring) fra fil -X POST bruk http post -o skriv til outputfil 37
  • 38. Tillegg 38 For de som er vil ha mer
  • 39. Klass API SSBs tjeneste for Klassifikasjoner og kodelister https://www.ssb.no/klass KLASS API guide Alle eksempler i Klass API benytter cURL Source code on Github http://github.com/statisticsnorway/klass 39
  • 40. JSON-stat conv JSON-stat Conversion Tools https://github.com/badosa/JSON-stat-conv Forutsetter node.js installert Fleksible konverteringsverkt淡y jsonstat2csv - converts JSON-stat into CSV jsonstat2array - converts JSON-stat into an array of arrays jsonstat2arrobj - converts JSON-stat into an array of objects jsonstat2object - converts JSON-stat into an object 40
  • 41. Enkelt R-eksempel med ferdig datasett 41
  • 42. R: Lag eget datasett (POST) eksempel Se ogs奪 MyRland http://www.myrland.one http://www.myrland.one/2016/06/07/ssbs-api-for-a-laste-ned-bensin-og-dieseldata/ 42