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 zahtevka

https://opendata.si/vreme/report/?lat=47.05&lon=12.92

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.