Miljöbarometerns API för öppna data

Artikel

Med Miljöbarometerns API kan du visa data och information om indikatorer eller åtgärder i Excel. Funktionen kan även användas av utvecklare, forskare och andra intressenter för att hämta data eller information från Miljöbarometern och integrera den i egna applikationer, analyser eller visualiseringar.

Miljöbarometerns API för öppna data är en funktion som möjliggör åtkomst till miljö-och hållbarhetsdata på ett strukturerat och effektivt sätt. Detta bidrar till ökad transparens, främjar datadriven utveckling och stödjer arbetet med att nå ut med informationen via fler kanaler.

API står för Application Programming Interface, vilket innebär en teknik som gör det möjligt för olika system att kommunicera och utbyta information med varandra.

I denna instruktion får du en översikt av hur du kan använda API:et.

Åtkomst till API:et

För att nå Miljöbarometerns API för öppna data använder du följande URL-struktur:
https://<domännamn>/opendata/<tabellnamn>

<domännamn> är specifikt för respektive kund, till exempel "osteraker.malbarometern.se".
<tabellnamn> är namnet på den tabell du vill hämta data från.

Exempel:
Om du vill hämta data från tabellen "indicators" från Österåkers kommun använder du:
https://osteraker.malbarometern.se/opendata/indicators

Datatabeller

Översikt av tillgängliga tabeller och vad de innehåller.

indicators visar indikatorer.
data visar mätdata. Kan kopplas till tabellen indicators via fältet element_id.
activities Visar åtgärder.
projects visar redovisningsprojekt, den högsta nivån i datastrukturen.
mainareas visar huvudområden.
subareas visar delområden.

Öppna tabell i Excel

Det lättaste sättet är att klicka Öppna (Ctrl+O) och sedan ange länken till tabellen i filväljaren, fältet Filnamn. Klicka sedan Öppna och ange Öppna som en XML-tabell.

Öppna API i Excel

Innehållet från tabellen visas nu i Excel. Du kan lägga till egna kolumner eller filtrera innehållet i tabellen med hjälp av funktionerna i Excel. Om du vill läsa in tabellen på nytt klickar du Uppdatera.

Granska API i Excel

Dataformat

Med parametern $format kan du ange vilket utdataformat du önskar.

XML: Används som standard, passar bra för att visa i Excel.
JSON: Vanligt för webbutveckling och JavaScript-baserade applikationer.
CSV: Kommaseparerade värden.

Exempel:
Om du vill hämta data i Json-format lägger du till parametern $format=json i urlen.
https://osteraker.malbarometern.se/opendata/indicators?$format=json

Filter

Om du vill filtrera data, till exempel hämta mätdata för en viss indikator lägger du till en filterparameter. Parametrar som inte har prefixet ”$” tolkas som filter-parametrar.

Exempel:
Fältet parent_id används för att hämta alla indikatorer under ett visst delområde.
https://osteraker.malbarometern.se/opendata/indicators?parent_id=44306e0a

Fältet element_id används för att hämta mätdata för en specifik indikator
https://osteraker.malbarometern.se/opendata/data?element_id=1e9c37bd

Fälturval

Med parametern $out kan du ange vilka fält du vill ta med i datasetet. Fälten anges med en kommaseparerad lista. Som standard ingår alla fält.

Exempel:
Hämta fyra utvalda fält från tabellen indicators
https://osteraker.malbarometern.se/opendata/indicators?$out=name,unit,datasource,last_updated_on

Sortering

Med parametern $sort kan du ange vilka fält som datasetet ska sorteras efter. Fälten anges med en kommaseparerad lista.

Exempel:
Sorterar tabellen indicators utifrån namn och därefter datakälla
https://osteraker.malbarometern.se/opendata/indicators?$out=name,unit,datasource,last_updated_on&$sort=name,datasource