Svenska myndigheter har stora mängder data som hittills har varit svår (för att inte säga omöjlig i många fall) att komma åt. Tänk på hur antalet vädersajter har exploderat på senaste, till stora delar tack vara norrmännens gratis statligt finansierade väder API från yr.no. Hur hade det sett ut om samma data var tillgängligt gratis (eller billigt, vilket det inte är nu) i ett användbart format från SMHI? Eller för den delen om data från alla svenska myndigheter var allmänt tillgänglig?

Från och med idag så är det faktiskt lag på att myndigheter ska göra sin data tillgängligt på ett enkelt sätt (= XML, RSS, REST etc), idag så börjar nämligen PSI-lagen gälla. Myndigheterna får endast ta betalt för datan i den mån att de täcker sina kostnader, men eftersom det faktiskt inte kostar många utvecklingstimmar att tillhandahålla ett API till redan existerande system så borde det inte kosta särskilt mycket att använda dessa tjänster.

Nu är det bara att hoppas att myndigheterna verkligen följer denna lag. För att pusha generaldirektörerna lite så har Jonas Lejon och Joakim Jardenberg författat ett öppet brev till dem:

Kära generaldirektörer, låt oss tillsammans göra världen bättre!

Ni sitter sedan många år tillbaka på stora mängder data som är intressant ur flera aspekter. Det handlar om information som vi skattebetalare redan betalt för. Olika aktörer i samhället kan vidareutnyttja information för olika ändamål, t.ex. genom skapandet av nya e-tjänster, såväl kommersiella och ideella. Men ofta har det varit förknippat med stora kostnader och svårtillgängliga lösningar. Äntligen ser vi en ändring komma till stånd.

Att vi entreprenörer kan ta del av denna information även elektroniskt har vunnit laga kraft sedan idag, den 1:a juli 2010. Den så kallade PSI-lagen (Prop. 2009/10:175) öppnar upp för stora möjligheter att skapa tjänster som förbättrar vardagen för oss alla.

Att ni själva sitter på kunskapen att förädla denna information i viss mån är mycket möjligt, rent av sannolikt, men om fler får möjlighet att jobba tillsammans så kommer garanterat resultaten att bli ännu bättre. Det saknas sannerligen inte internationella exempel på de effekter man får av att släppa publikt data tillgängligt för vidareutnyttjande.

Vi vill därför uppmana alla myndigheter och deras chefer att snarast börja arbeta i PSI-direktivets anda och uppfylla den intention som lagen speglar. Citerar från regeringskansliets sida om PSI – vidareanvändning av information:

”Syftet med lagen är att främja utvecklingen av en informationsmarknad genom att underlätta enskildas användning av handlingar som tillhandahålls av myndigheter.”

För att detta ska bli verklighet krävs i praktiken ett API till era tjänster. Vi vill därför med detta brev uppmärksamma er på behovet av att ni skyndsamt öppnar upp en sådan möjlighet. Först då kan vi börja jobba på allvar, och först då kan både ni, vi, lagstiftarna och samhället se den fulla nyttan av den utveckling som startar nu. Vi är många som är villiga att hjälpa till, så se det här brevet också som en utsträckt hand. Dialogen är igång, nu är bollen er.

Ovanstående text är i huvudsak författad av Jonas Lejon (ansvarig bland annat för tjänsten govdata.se), bearbetad av Joakim Jardenberg (bland annat projektledare för Makten och Öppenheten) och helt fri att kopiera, bearbeta och vidarebpublicera enligt CC0.

Google Buzz API
Googles konkurrent till Twitter har nu äntligen fått ett API. Nu kan man söka bland statusuppdateringar, posta statusuppdateringar, hämta och uppdatera användarprofiler, hämta en användares social graph etc. Buzz blev snabbt integrerat i TweetDeck, Seesmic och andra Twitterklienter. Sedan Google klantigt introducerade Buzz så har inte så mycket hänt, kanske kan APIet ge Buzz lite välbehövlig hjälp att få fler aktiva användare.

BigQuery API
Med detta API så kan man analysera väldigt stora datamängder via SQL (eller en SQL-dialekt om man ska vara exakt). Än så länge är BigQuery APIet inte öppet för alla och det går inte att ladda upp sin egen data. De datamängder de tillhandahåller är bla information om artikeluppdateringar från Wikipedia på 314 miljoner rader och data om internetuppkopplingar på 60 miljarder rader – så det är verkligen ordentliga mängder data som detta API kan hantera.

Google Latitude API
Google Latitude låter en hålla reda på sin egen och sina vänners geografiska position, nu kan man använda detta API för att integrera Latitude i sina egna appar.

Google Moderator API
Med detta REST API så kan man samla in ideer, förslag och rekommendationer från en stor mängd användare och sedan låta användarna rösta på vilken som är den bästa ideen.

Google Font API
Detta API gör det enkelt att använda andra typsnitt än standard webbtypsnitten på vilken webbsida som helst. Allt man behöver göra är att importera en javascript fil och ange vilken font i Google Font Directory som du vill använda (lite enklare än Flash replacement).

Ladda upp data
Med Predictions API så kan man göra förutsägelser baserat på mönster i en stor datamängd, tex produktrekommendationer (please lovefilm ta en titt på det här!) eller hitta spam (något för Twitter). Först laddar man upp sin träningsdata till Google Storage (deras konkurrent till Amazon S3). Denna data måste vara formaterad i key-value pairs – om man laddar upp en massa emails så ska alltså alla mail som nämner hemliga Nigerianska bankkonton vara märkta som spam (Google använder detta API för att hitta spam redan).

Träna systemet
När man har laddat upp all sin data så kör man Predictions APIets träning så att APIet kan identifiera mönster. Exakt hur detta går till går inte Google in på, men tydligen har de ett stort antal machine learning algoritmer att välja på och de väljer automatiskt den algoritm som passar bäst för den givna datamängden.

Fråga systemet
Slutligen så kan man skicka in en fråga, tex texten på ett nytt email, och få tillbaka en förutsägelse (i detta fall om det är spam eller inte). Har man använt en stor mängd data av bra kvalitet så verkar man kunna få rätt bra resultat enligt vad jag har sett. Allt detta kan göras via REST, så det bör inte vara några större problem att integrera i vilken applikation som helst (när man får tillgång till APIet dvs).

För mer detaljer om detta högintressanta API så ta en titt på denna video. De börjar presentera Predictions API efter ca 25 minuter…

Bland annat så kommer presentationen att täcka hur man kan komma åt resurser på sin mobiltelefon via REST APIer, alltså hur man kan använda sin telefon som en web service. Iden är att utvecklare ska kunna använda en mobiltelefons kamera precis lika lätt som de kan hämta bilder från Flickr eller att skicka SMS från en mobiltelefon precis lika lätt som det går att skicka meddelanden via Twitter. Kort sagt så kommer mobiltelefonen bara att vara en tjänst bland andra och det kommer att finnas ännu fler möjligheter att utveckla användbara och värdefulla applikationer.

Så om du ska till SWDC så boka in ”The Phone in the Cloud” under dag 2 av konferensen i din kalender!

Filtrera på butik, köpcentrum eller geografi
Det finns två format man kan få data i, antingen via ett RSS2.0 feed som innehåller något begränsad information om varje erbjudande eller via rabatten.ses eget format RabattenAdRSS som innehåller fullständig information om erbjudanden. Oavsett vilket format som man vill ha informationen i så krävs endast ett HTTP-anrop, inga API-nycklar eller annan identifikation behövs. Varje anrop kräver parametern ”mode” som anger hur man identifierar vilka butiker man vill ha information om, ”mode” har följande möjliga värden:

• store eller snabbkod_store – endast erbjudanden från en angiven butik som sedan idenfieras med parametrarna storeid eller snabbkod
• mall – endast erbjudanden från butiker i ett givet köpcentrum som identifieras med parametern mallid
• county – endast annonser från butiker i ett visst län som identifieras med parametern countyid
• locality – endast annonser från butiker i en given postort som anges med parametern localityid
• geoip_county – endast annonser från butiker i det län som IP-adressen som anges med parametern ip är registrerad i
• geoip_location – endast annonser från butiker i en postort som IP-adressen i parametern ip är registrerad i

Via http://www.rabatten.se/rss.aspx?format=mall så får man tag på  alla köpcentrum som rabatten.se har registrerade. Än så finns inget enkelt sätt att få tag på storeid, men det jobbar Rabatten.se på för fullt så det kommer nog inom några dagar.

Exempel API-anrop
För att ta reda på vilka rabatter som Kjell & Co i Gallerian, Stockholm så gör man anropet:
http://www.rabatten.se/rss.aspx?format=rss&mode=store&storeId=1001

För att få reda på alla specialerbjudanden i Stockholm så gör anropet:
http://www.rabatten.se/rss.aspx?format=rabattenadrss&mode=county&countyid=12

I det sista anropet så kommer informationen tillbaka i RabattenAdRSS formatet, dvs XML med så mycket data som möjligt:

...
<ad>
	<adid>374</adid>
	<category>Hälsa & skönhet - Smink & parfym</category>
	<title>BIOTHERM</title>
	<description>club15 BIOTHERM ...</description>
	<ordinaryprice>320.00</ordinaryprice>
	<ordinarypriceunit>st</ordinarypriceunit>
	<rebateprice>0.00</rebateprice>
	<rebatepriceunit>st</rebatepriceunit>
	<compareprice></compareprice>
	<comparepriceunit></comparepriceunit>
	<rentalprice></rentalprice>
	<rentalmonths></rentalmonths>
	<priceisinpicture>False</priceisinpicture>
	<link>http://www.rabatten.se/default.aspx?adid=374&channelid=2</link>
	<image1>http://data.rabatten.se/ads/....jpg</image1>
	<image2>http://data.rabatten.se/ads/....jpg</image2>
	<image3>http://data.rabatten.se/ads/....jpg</image3>
	<store>
		<storeid>1821</storeid>
		<storename>Kicks</storename>
		<storelogo>http://data.rabatten.se/logo....png</storelogo>
		<storestreetaddress>Aniaraplatsen 2</storestreetaddress>
		<storepostaladdress>19147 SOLLENTUNA</storepostaladdress>
		<storecounty>Stockholm</storecounty>
		<storelocationx>59.4272291</storelocationx>
		<storelocationy>17.9525737</storelocationy>
	</store>
	...
</ad>
...

För mer information så ta en titt på Rabatten.ses egen API dokumentation och kodexempel.

Ett API med stor potential
Jag tycker att rabatten.se har ett mycket intressant API där man kan komma åt värdefull data på ett enkelt sätt. Speciellt gillar jag att man kan få fram lokala annonser genom att endast ange IP-adresser i API-anropet. Värdet på APIet är än så länge begränsat om man inte bygger tjänster för de som bara shoppar i Stockholms innerstad, men när Rabatten.se täcker hela Sverige så har detta API potentialen att bli ett av landets mest intressanta.

Första steget som vanligt att skaffa en API-nyckel, sedan är det bara att börja använda APIet. Det finns två sätt att hitta vårdcentraler, antingen anger man en adress eller en position:

http://api.omvard.se/<DIN NYCKEL>/vardgivare/nara/?gatuadress=<GATUADRESS>&postnummer=<POSTNUMMER>&postort=<POSTORT>&format=<XML eller JSON>

http://api.omvard.se/<DIN NYCKEL>/vardgivare/nara/?longitud=<LONGITUD>&latitud=<LATITUD>&format=<XML eller JSON>

Tillbaka får man då XML eller JSON som innehåller namn, adress, kommun och position för de 10 närmsta vårdcentraler från den angivna adressen/positionen, tex:

<?xml version="1.0" encoding="ISO-8859-1" ?>
<vardgivarlista>

    <vardgivare>
        <namn>Vårdcentralen Tågaborg</namn>
        <gata>Tågagatan 38</gata>
        <postort>Helsingborg</postort>
        <postnummer>25439</postnummer>
        <kommun>Helsingborg</kommun>
        <landsting>Skåne</landsting>
        <longitud>12.6906494</longitud>
        <latitud>56.0558033</latitud>
        <url>http://www.omvard.se/skane/vardcentralen-tagaborg</url>
    </vardgivare>

    ...

</vardgivarlista>

Än så länge så har APIet rätt begränsad funktionalitet, helst vill man ju ha tillgång till all den information som OmVård har om vårdinrättningar och vårdköer och dessutom så skulle det vara användbart att kunna skicka in recensioner etc. OmVård verkar öppna till förslag på utökningar och förbättringar av APIet, så har du en brilliant ide som kräver mer av deras API så tveka inte att kontakt dem.

Själv har jag precis spenderat tid med APIet då jag som småbarnspappa vill ha ett enklare sätt att hitta billiga barnkläder, resultatet av det arbetet blev detta inlägg och sajten begagnadebarnkläder.nu (där man kan hitta barnkläder från katvig, molo, Hello Kitty mm). Andra som använder Traderas API är prisjakt och annonskartan.

Application Keys – nycklarna till Traderas API
För att kunna använda Traderas API så krävs att man har registrerat sig på Tradera Developer Center och godkänt Terms of Use och deras Logo Terms of Use. Dessa dokument beskriver hur man ska hantera innehållet från Tradera och hur man ska visa deras logga, i princip så kan man sammanfatta dem med ”var snäll”, ”visa vår logga” och ”visa inte information äldre än 6 timmar” (men jag är ingen advokat så läs dokumenten själva..). När man väl är registrerad så måste man skapa en applikation (bara att ange namn och en kort beskrivning) och så får man en Application Key som man kan använda i alla sina API-anrop.

När man är inloggad i Traderas ”Developer Center” så kan man, förutom att administrera sina applikationer, hantera sin Sandbox. I denna sandlåda så kan man skapa annonser och användare som man kan använda för att testa sina applikationer, det är ju inte alltid man vill gå direkt mot livesajten i sin testning.

APIet är indelat i två delar – PublicServices för de metoder som inte kräver autentisering och RestrictedServices för de metoder som kräver autentisering. Majoriteten av API metoderna finns tillgängliga både via SOAP och REST. Några få finns endast tillgängliga via SOAP, tex när man vill göra en lite mer avancerad sökning efter annonser.

PublicServices – API för att hämta annonser
Med public services så kan man hämta annonskategorier, söka efter annonser baserat på sökord, kategorier etc, hämta information om en specifik annons med mera.

För att få fullständig information om en given annons, vars id man har hämtat via sökningar med andra API-metoder så använd följande REST anrop:
http://api.tradera.com/v2/publicservice.asmx/GetItem?appId=<DITT APP ID>&appKey=<DIN APP NYCKEL>&itemId=<ANNONS ID>

Tillbaka får man då XML som beskriver annonsen i detalj – säljarens beskrivning av varan, nuvarande bud, när slutar auktionen, länk till thumbnail bild, vad finns det för leveranskostnader på varan, vem är säljaren och vem har bjudit högst just nu etc etc.

RestrictedServices – API för att administrera annonser
Med RestrictedServices metoderna så kan man administrera annonser i en användares namn. Användaren i fråga måste då ge sin tillåtelse till detta genom att logga in med sitt Tradera användarnamn och lösenord. Detta görs helt utan att API-utvecklaren får tillgång till användarnamnet och lösenordet, istället ber man om ett Token, sedan hanterar Tradera autentiseringen av användaren och skickar tillbaka detta Token. Ett sådant giltigt token måste sedan skickas med i alla RestrictedServices anrop.

När man väl har ett Token så kan man lägga upp nya annonser, lägga upp bilder, lämna feedback på en köpare eller säljare med mera. Dessa metoder är värdefulla om man vill bygga verktyg som underlättare administrationen av ett stort antal annonser på Tradera.

API begränsningar
Som default så kan man endast anropa varje API-metod 100 gånger inom en 24 timmars period, detta för att undvika för hårt tryck på APIet. Behövs mer anrop så kontakta Tradera med en vettig motivation så verkar det inte vara några större problem att få fler än 100 anrop/dygn.

Har du egen erfarenhet av att använda Traderas API? Har du en coola sajt eller verktyg som använder Traderas API? Dela med dig i kommentarerna nedan eller kontakta mig direkt.

Kundtjänst via XML eller JSON
Kundos API kräver inte någon API-nyckel, det är bara att sätt igång och kalla metoderna. För att hämta ner all information så använd anropet:

http://kundo.se/api/<FÖRETAGSSLUG>.xml

Detta returnerar alla frågor, förslag etc i XML, använd .json för att få tillbaka informationen i JSON format istället. Företagsslug är addressen som företaget har på kundo.se, mitt eget Bröllopia har tex http://kundo.se/brollopia så om vi var premiumkunder (endast de har tillgång till APIet, se nedan) så skulle anropet vara http://kundo.se/api/brollopia.json.

Vill man inte ha tillbaka all information utan endast för en typ av inlägg så använd anropet:

http://kundo.se/api/<FÖRETAGSSLUG>/<TYP>.xml

Typ kan vara ”q” för frågor, ”p” för problem, ”s” för förslag eller ”b” för beröm. För att få fram alla förslag till Kundos eget Kundo konto så anropar man alltså http://kundo.se/api/kundo/s.xml och då får man tillbaka sammanfattande information om varje förslag:

<?xml version="1.0" encoding="utf-8"?>
<response>
    <resource>
    	<title>Tankar om det nya premiumkontot ... </title>
    	<num_comments>2</num_comments>
    	<absolute_url>http://kundo.se/org/kundo/d/tankar-om-det-... </absolute_url>
    	<uri>/api/dialog/kundo/18512.xml</uri>
    	<num_votes>0</num_votes>
    	<pub_date>2010-01-18 13:52:25</pub_date>
    	<id>18512</id>
    </resource>

    ...

</response>

Det går också att hämta mer information om ett givet inlägg genom att använda dialog id-nummret, för att få ut hela texten på förslaget ovan så är URLen http://kundo.se/api/dialog/kundo/18512.xml och för att få ut alla kommentarer till förslaget så använder man http://kundo.se/api/comment/kundo/18512.xml.

Än så länge så kan man inte skicka in information till Kundo via APIet. Men om det är något som du behöver så kan du ju alltid föreslå det på Kundo.

API endast för betalande kunder
Idag så är APIet tyvärr endast tillgängligt för Kundos betalande premiumkunder (800kr/månaden). Givetvis så ska OpenWorks (teamet bakom Kundo) ha full rätt att ta betalt för sin tjänst, men personligen så tror jag att det skulle löna sig för dem att alla kunde använda APIet. Mer gratis utvecklartid och innovation som marknadsför Kundo är något som jag tror skulle vara bra för Kundo i långa loppet.

Många svenska myndigheter säljer sin data dyrt, det är tex inte gratis att använda data från SMHI. Stora delar av denna försäljning är till andra myndigheter, och om man tar bort denna del av försäljningen så finns det inte mycket kvar. Räknar man dessutom med skattintäkter från de nya tjänster som kan skapas baserat på rådatan från myndigheterna så blir kostnaden ännu mindre. Peter Kranz på opengov.se säger att ”Det strömmar ju ut människor från it-utbildningarna varje år som inte vill något annat än att programmera och utveckla nya och intressanta tjänster. Det enda som saknas i dag är tillgång på rådata.”.

Om ni är intresserade av att få tillgång till data från myndigheter så rekommenderar jag att ni följer vad som händer inom det området på opengov.se. Det händer också intressanta saker på hackamakten.se.

Vad gör SMHI?
Enligt Leif Stenbom som är webbkoordinator på SMHI så har de ”för närvarande inte några konkreta planer på att öppna APIer”, men de är väl medvetna om att fler och fler bygger mashups på data från yr.no. Det SMHI satsar på just nu är en ny webbsida där fler och bättre tjänster för allmänheten är prioriterat. Läser man SMHIs blogg om utvecklingen av den nya sajten så märker man att de är inspirerade av konkurrensen med yr.no – än blir det alltså inget svenskt väder-API, men det blir i alla fall en bättre vädersajt.

Svenska Dagbladet byter till yr.no
Det är inte bara nystartade webbsajter som använder sig av APIet från yr.no, även några av SMHIs kunder experimenterar med det norska APIet. Svenska Dagbladet testar för närvarande att använda yr.no för sin nya vädersida, den är för närvarande i beta men ska ersätta den nuvarande vädersidan i årskiftet. Anledningarna till att byta från SMHI till yr.no är enligt Pelle Sten, utvecklingsredaktör på SvD.se ”En stor anledning är läromöjligheten. Vi får mycket kunskap av att skapa en mashup mellan Google Maps och YR.no. Kunskap som vi kan använda oss i vår fortsatta utveckling av sajten. Vi får större möjligheter att styra utvecklingen när vi har kontroll över koden. Sedan ska vi inte sticka under stolen med att detta är billigare än att köpa in tjänsten från någon av de traditionella vädertjänsterna.”. Mer om vad man kan göra med SvDs nya vädertjänst hittas på deras utvecklingsblogg.

Nya vädersajter
Två av de bästa nya vädersajterna som använder APIet från yr.no är Vackertväder.se och Blirdetsol.se. Båda använder den data de hämtar från yr.no för att presentera väderdata på ett enkelt och snyggt sätt, inte bara den gamla traditionella väderkartan a la John Pohlman. Min personliga favorit är Vackertväder eftersom man där väldigt snabbt kan få en översikt över vad vädret kommer att bli (vackertväder började för övrigt som ett projekt på första 24 hour business camp). De har också en väldigt bra widget som gör det lätt att visa väder på sin egen sajt.

Blirdetsol visar väderdata från yr.no på en Google Map så det är en mycket bra sajt för att snabbt för översikt över vad vädret är i ett större område – tex hela Sverige eller Europa.

yr.no har förändrat vädermarknaden
Väderdata samlas in av olika länders meterologiska institut, men det räcker ju inte med lokal information för att göra en bra väderprognos man måste ju ha väderdata från andra länder också. Därför bytes data fritt mellan länder, så mycket av den data som man kan få tag på via det norska APIet är inte insamlat av det norska Meteorologisk Institutt. Att denna data nu är gratis för alla och envar måste reta gallfeber på andra länders vädertjänster, de tjänar ju ofta pengar på att sälja väderprognoser. Deutscher Wetterdienst säljer tex vädertjänster till tyska flygplatser för 20 miljoner euro per år. Nu när europeisk väderdata väl är tillgängligt gratis så kommer detta förhoppningsvis att tvinga andra europeiska länders meterologiska institut (inklusive SMHI) att också släppa den skattefinansierade informationen fri!