API för luftkvalitet

JSON

Parameter	Beskrivning
URL	https://mitt.sundsvall.se/api/air/v1/air.json
HTTP metod	GET
Innehåll	application/json

Exempel på ett lyckat svar

{
	"status":"success",
	"data":{
		"pm10":[
		  {
		    "date": "2015-05-06T21:15:00.000+0200",
		    "value": 0.553,
		    "station": "sundsvall"
		  },
		  {
		    "date": "2015-05-06T21:15:00.000+0200",
		    "value": 8.365845,
		    "station": "oleico4"
		  }
		],
		"no2":[
		  {
		    "date": "2015-05-06T21:15:00.000+0200",
		    "value": 14.383,
		    "station": "sundsvall"
		  },
		  {
		    "date": "2015-05-06T21:15:00.000+0200",
		    "value": 20.913,
		    "station": "oleico4"
		  }
		]
	}
}

Exempel på ett misslyckat svar där från datum ej gick att parsa.

{
  "status": "error",
  "message": "Kunde inte parsa fråndatum."
}

CSV

Parameter	Beskrivning
URL	https://mitt.sundsvall.se/api/air/v1/air.csv
HTTP metod	GET
Innehåll	application/csv

Parametrar i API

Följande parametrar finns tillgängliga. Alla parametrar är valfria.

Parameter	Beskrivning
dateFrom	Datum att hämta ifrån. Exempel: 2016-01-02T21:00:00
dateTo	Datum att hämta till. Exempel: 2016-01-008T21:16:00
type	no2,pm10
station	Oleico4 (Bergsgatan 24), Sundsvall_gen2 (Köpmangatan 9), Sundsvall (Landsvägsallén/Gamla E4, Strandgatan 8 är närmsta adress)
limit	Antal poster som erhålls ur respektive array. exempel: limit=4.
order	Posterna sorteras på datum. Denna ordning kan ändras med ASC,DESC

Exempel

Några exempel

https://mitt.sundsvall.se/api/air/v1/air.json?dateFrom=2016-01-02T21:00:00&dateTo=2016-01-08T21:16:00&type=no2&limit=6&order=DESC

{
	"status":"success",
		"data":{
			"no2":[
				{
					"date":"2016-01-02T13:00:00.000+0200",
					"value":4.032,
					"station":"sundsvall"
				},
				{
					"date":"2016-01-02T13:00:00.000+0200",
					"value":8.724,
					"station":"oleico4"
				},
				{
					"date":"2016-01-02T12:45:00.000+0200",
					"value":4.795,
					"station":"sundsvall"
				},
				{
					"date":"2016-01-02T12:45:00.000+0200",
					"value":5.276,
					"station":"oleico4"
				},
				{
					"date":"2016-01-02T12:30:00.000+0200",
					"value":6.497,
					"station":"sundsvall"
				},
				{
					"date":"2016-01-02T12:30:00.000+0200",
					"value":5.782,
					"station":"oleico4"
				}
			]
		}
}

Senaste värderna från station oleico4

https://mitt.sundsvall.se/api/air/v1/air.json?limit=1&order=DESC&station=oleico4

{
	{
		status: "success",
		data: {
			pm10: [
					{
						date: "2016-01-02T13:00:00.000+0200",
						value: 31.258057,
						station: "oleico4"
					}
			],
			no2: [
					{
						date: "2016-01-02T14:15:00.000+0100",
						value: 71.47601999999999,
						station: "oleico4"
					}
			]
		}
	}
}

Licens för användning

Informationen om luftdata kan återanvändas fritt. Det gäller all information som ges tillgång via API. Informationen lyder under en Creative commons CC-0-licens http://creativecommons.org/about/cc0.

Uppdateringar och ändringar i API

Alla uppdateringar och ändringar av detta API kommer att publiceras på Sundsvalls kommuns utvecklingsblogg. Uppdateringar på utvecklingsbloggen kan följas via RSS.

Kända brister i datamängd

All data som är tillgänglig via API är icke kvalitetsgranskad rådata från mätare/sensor, detta data kan innehålla enstaka felaktiga mätningar. Kommunen sammanställer även den kvalitetsgranskade datan utifrån denna rådata i ett senare skede men detta data finns inte tillgänglig i realtid.

Kontakt

Om du har frågor eller funderingar rörande vårt API är du välkommen att höra av dig.

Jari Koponen
070-601 23 05
jari.koponen@sundsvall.se