|
|
| (54 mellanliggande versioner av 2 användare visas inte) |
| Rad 1: |
Rad 1: |
| − | {| align="right"
| + | Informationen är flyttad till [https://temperatur.nu/info/api/ https://temperatur.nu/info/api/] |
| − | | __TOC__
| |
| − | |}
| |
| − | Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.
| |
| − | | |
| − | Aktuell API-version 1.0. Observera att formatet för version 1.0 ännu ej är helt fastställt - mindre ändringar kan komma att ske.
| |
| − | | |
| − | Data returneras i XML-format
| |
| − | | |
| − | ==Support==
| |
| − | För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].
| |
| − | | |
| − | ==Villkor==
| |
| − | *Skriver du ett kul program som använder detta API? Kontakta [mailto:[email protected] info @temperatur.nu]! | |
| − | *APIet får ej accessas med samma förfrågan oftare än var femte minut från klienterna. Om detta villkor bryts kan det IP-nummer som överskrider tidsgränsen tillfälligt att blockeras.
| |
| − | *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.
| |
| − | *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.
| |
| − | *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.
| |
| − | *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.
| |
| − | | |
| − | ==Kort beskrivning==
| |
| − | APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.
| |
| − | Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!
| |
| − | | |
| − | ==Var finns APIet?==
| |
| − | Den senaste versionen av APIet hittar du på www.temperatur.nu/api/tnu.php
| |
| − | För att använda en specifik version kan du använda www.temperatur.nu/api/tnu_{version}.php, ex www.temperatur.nu/api_1.0.php för version 1.0.
| |
| − | Inga garantier ges för att olika versioner av APIet är kompatibla med varandra. Målsättningen är dock att APIerna skall vara bakåtkompatibla.
| |
| − | | |
| − | ==Parametrar==
| |
| − | {| border=1 class="wikitable"
| |
| − | |-
| |
| − | ! Parameter
| |
| − | ! Beskrivning
| |
| − | ! Kan ej användas med
| |
| − | ! Introducerad i API-version
| |
| − | |-
| |
| − | | p
| |
| − | | Anger för vilka orter data skall returneras - kommaseparerad lista
| |
| − | | lat, lon, num
| |
| − | | 1.0
| |
| − | |-
| |
| − | | dc
| |
| − | | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.
| |
| − | |
| |
| − | | 1.0
| |
| − | |-
| |
| − | | simple
| |
| − | | Minimal output, returnerar endast <title>, <id> och <temp>
| |
| − | | verbose
| |
| − | | 1.0
| |
| − | |-
| |
| − | | verbose
| |
| − | | Returnerar alla fält för orten, se beskrivning nedan
| |
| − | | simple
| |
| − | | 1.0
| |
| − | |-
| |
| − | | coordinates
| |
| − | | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.
| |
| − | | verbose
| |
| − | | 1.0
| |
| − | |-
| |
| − | | lat
| |
| − | | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.
| |
| − | | p
| |
| − | | 1.0
| |
| − | |-
| |
| − | | lon
| |
| − | | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..
| |
| − | | p
| |
| − | | 1.0
| |
| − | |-
| |
| − | | num
| |
| − | | Används tillsammans med lon och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5.
| |
| − | | p
| |
| − | | 1.0
| |
| − | |-
| |
| − | |}
| |
| − | | |
| − | ==Beskrivning av returnerade fält==
| |
| − | {| border=1 class="wikitable"
| |
| − | |-
| |
| − | ! Fält
| |
| − | ! Beskrivning
| |
| − | ! parameter som visar
| |
| − | ! parameter som döljer
| |
| − | ! Visas som standard
| |
| − | ! Introducerad i API-version
| |
| − | |-
| |
| − | | <title>
| |
| − | | Mätpunktens namn på temperatur.nu
| |
| − | |
| |
| − | |
| |
| − | | X
| |
| − | | 1.0
| |
| − | |-
| |
| − | | <id>
| |
| − | | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information
| |
| − | |
| |
| − | | simple
| |
| − | | X
| |
| − | | 1.0
| |
| − | |-
| |
| − | | <temp>
| |
| − | | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.
| |
| − | |
| |
| − | |
| |
| − | | X
| |
| − | | 1.0
| |
| − | |-
| |
| − | | <lat>
| |
| − | | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.
| |
| − | | coordinates, verbose
| |
| − | |
| |
| − | |
| |
| − | | 1.0
| |
| − | |-
| |
| − | | <lon>
| |
| − | | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.
| |
| − | | coordinates, verbose
| |
| − | |
| |
| − | |
| |
| − | | 1.0
| |
| − | |-
| |
| − | | <lastUpdate>
| |
| − | | Tidpunkt då informationen senast uppdaterades på temperatur.nu
| |
| − | | verbose
| |
| − | |
| |
| − | |
| |
| − | | 1.0
| |
| − | |-
| |
| − | | <kommun>
| |
| − | | Den kommun som mätpunkten ligger i.
| |
| − | | verbose
| |
| − | |
| |
| − | |
| |
| − | | 1.0
| |
| − | |-
| |
| − | | <lan>
| |
| − | | Det län som mätpunkten ligger i.
| |
| − | | verbose
| |
| − | |
| |
| − | |
| |
| − | | 1.0
| |
| − | |-
| |
| − | | <url>
| |
| − | | Url till mätpunktens temperatur och grafer på www.temperatur.nu
| |
| − | | verbose
| |
| − | |
| |
| − | |
| |
| − | | 1.0
| |
| − | |-
| |
| − | | <dist>
| |
| − | | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.
| |
| − | | lat & lon
| |
| − | | simple
| |
| − | |
| |
| − | | 1.0
| |
| − | |}
| |
| − | | |
| − | ==Exempel==
| |
| − | | |
| − | Så här kan resultatet från en förfrågan på http://www.temperatur.nu/api/tnu_1.0.php?p=linkoping&verbose se ut:
| |
| − | <?xml version='1.0' encoding='iso-8859-1'?>
| |
| − | <rss version="2.0">
| |
| − | <channel>
| |
| − | <title>Temperatur.nu API 1.0</title>
| |
| − | <link>http://wiki.temperatur.nu/index.php/Api</link>
| |
| − | <item>
| |
| − | <title>Linköping/Centrum</title>
| |
| − | <id>linkoping</id>
| |
| − | <temp>10,1</temp>
| |
| − | <lat>58.414297</lat>
| |
| − | <lon>15.628788</lon>
| |
| − | <lastUpdate>2010-05-04 09:29:14</lastUpdate>
| |
| − | <kommun>Linköping</kommun>
| |
| − | <lan>Östergötlands län</lan>
| |
| − | <url>http://www.temperatur.nu/linkoping.html</url>
| |
| − | </item>
| |
| − | </channel>
| |
| − | </rss>
| |
| − | | |
| − | Så här kan resultatet från en förfrågan på http://www.temperatur.nu/api/tnu.php?lat=58.376761&lon=15.562916&num=3 se ut:
| |
| − | | |
| − | <?xml version='1.0' encoding='iso-8859-1'?>
| |
| − | <rss version="2.0">
| |
| − | <channel>
| |
| − | <title>Temperatur.nu API 1.0</title>
| |
| − | <link>http://wiki.temperatur.nu/index.php/Api</link>
| |
| − | <item>
| |
| − | <title>Linköping/Jägarvallen</title>
| |
| − | <id>jagarvallen</id>
| |
| − | <temp>11,4</temp>
| |
| − | <dist>2,5</dist>
| |
| − | </item>
| |
| − | <item>
| |
| − | <title>Linköping/Ryd</title>
| |
| − | <id>ryd</id>
| |
| − | <temp>10,2</temp>
| |
| − | <dist>3,8</dist>
| |
| − | </item>
| |
| − | <item>
| |
| − | <title>Linköping/Gottfridsberg</title>
| |
| − | <id>gottfridsberg</id>
| |
| − | <temp>11,3</temp>
| |
| − | <dist>4,7</dist>
| |
| − | </item>
| |
| − | </channel>
| |
| − | </rss>
| |
| − | | |
| − | ==Historik==
| |
| − | 2010-05-04 - Version 1.0 släpps
| |
| − | [[Kategori:www.temperatur.nu]]
| |
| − | [[Kategori:Mjukvara]]
| |
