Namen te storitve je ponuditi v nadalnjo rabo podatke o stanju vremena v Sloveniji. Storitev je s strani Kiberpipe brezplačna, potrebno pa je spoštovati avtorsko pravico in navesti vire podatkov, ki jih uporabljate.
Vsi podatki so na voljo v JSON zapisu. Vsak odgovor ima poleg izvirnih podatkov, še nekaj dodatnih podatkov:
- copyright
string, vsebuje naziv nosilca avtorske pravice nad podatki.
- updated
float, unix timestamp, vsebuje podatek o tem, kdaj so bili podatki posodobljeni.
Kjer so izvirni podatki koordinate, so dodane še koordinate v prostorskem referenčnem sistemu WGS84.
Vsak klic v primeru napake vrne odgovor:
null
Podatki so trenutno na voljo na http://opendata.si. Hostname se lahko v prihodnje spremeni.
URL: /vreme/report/
GET parametri:
- lat
float, ki predstavlja zemljepisno širino, npr. 46.051418. Veljavne vrednosti so med 45.21 in 47.05.
- lon
float, ki predstavlja zemljepisno dolžino, npr. 14.505971. Veljavne vrednosti so med 12.92 in 16.71.
Struktura vrnjenega rezultata:
- radar
vsebuje informacije o padavinah
- rain_level
jakost padavin v relativnih enotah iz radarske slike pred majem 2014 - je eno izmed 0 (bela), 25 (zelena), 50 (rumena), 75 (oranžna) ali 100 (rdeča)
- rain_mmph
jakost padavin v milimetrih na uro
- x, y
sta koordinati na transformirani sliki in sta načeloma namenjena debugiranju
- hailprob
odsek vsebuje informacije o predvideni toči
- hail_level
je eno izmed 0, 33, 66 ali 100 v naraščujoči verjetnosti toče
- forecast
odsek je modelska napoved vremena ALADIN
- clouds
pokritost neba z oblaki v odstotkih
- rain
dež v milimetrih padavin na triurno obdobje napovedi
- offset
časovni odmik od napovedi v urah.
Primer vrnjenega rezultata:
{
"status": "ok",
"copyright": "ARSO, Agencija RS za okolje",
"lon": "12.92",
"forecast": {
"y": 139,
"x": 32,
"updated": 1319277600,
"data": [
{
"forecast_time": "2011-10-22 20:00",
"clouds": 0,
"rain": 0,
"offset": 6
},
...
]
},
"radar": {
"y": 156,
"updated_text": "2011-10-22 19:39",
"updated": 1319305162,
"rain_level": 0,
"rain_mmph": 0,
"x": 99
},
"lat": "47.05",
"hailprob": {
"y": 52,
"updated_text": "2011-10-22 19:48",
"updated": 1319305695,
"hail_level": 0,
"x": 5
}
}
Vir podatkov: Agencija RS za okolje, http://www.arso.gov.si/
Za razvoj sem za preverjanje uporabil Google maps, za katerega je na voljo KML s polprosojno sliko vremena po Sloveniji.