O strani

Ideja

V Facebook skupini Startup Idrija je prišlo do ideje, da bi lahko po mestu Idrija vzpostavili merilce (temperatura, vlažnost, koncentracija prašnih delcev pm10...).

Na tej strani se bodo dodajale posamezne lokacije z merilci, ki bodo na voljo.

Vsakdo, ki ima merilec in bi želel posredovati meritve na to stran, naj me prosim kontaktira na info@matvoz.com (Matija Matvoz).

API za dodajo meritev

Trenutno sta na voljo podatka o temperaturi in vlažnosti.

Klic je:

http://www.matvoz.com/idrija/api/getinfo.php?humidity=70.10&temperature=24.20&pm=2&pm25=2&userguid=24D4E6E4-8B7E-D6E2-B947-A968F6993634&deviceid=1

Spremenljivke so sledeče:

humidity - decimalna številka od 0.00 do 100.00 (merska enota: %)
temperature - decimalna številka od -100.00 do 100.00 (merska enota: °C)
pm - (koncentracija prašnih delcev pm10) celo število ali decimalna številka (merska enota: µg/m3) - spremenljivka ni obvezna
pm25 - (koncentracija prašnih delcev pm2.5) celo število ali decimalna številka (merska enota: µg/m3) - spremenljivka ni obvezna
userguid - GUID oz unikatni niz, ki je vezan na uporabnika, dobite na začetku
deviceid - celo število, ki je vezano na lokacijo in na uporabnika, dobite na začetku

Klic vrne "ok", če so vsi podatki pravilni.

Testiranje je mogoče z GUID - 24D4E6E4-8B7E-D6E2-B947-A968F6993634. Ne vrača ničesar, info se shranjuje v log, ki je dosegljiv tukaj - http://www.matvoz.com/idrija/api/testlog.txt

API za download meritev posamezne lokacije

Klic je:

http://www.matvoz.com/idrija/api/sendinfo.php?location=otona_zupancica_30&date_from=2017-01-05&date_to=2017-01-06

Spremenljivke so sledeče:

location - lokacija, na strani, kjer je graf, se iz URLja vzame niz, ki je za zadnjim "/". Primer: stran je http://www.matvoz.com/idrija/lokacije/otona_zupancica_30, vzame se kar je napisano s krepko pisavo
date_from - začetni datum v formatu llll-mm-dd - vrnjene meritve so vključno s tem datumom
date_to - končni datum v formatu llll-mm-dd - vrnjene meritve so do začetka tega datuma

API se lahko proži tudi brez date_from in date_to. V tem primeru se vrnejo meritve zadnjih 24 ur.

Klic vrne tudi ime lokacije, koordinate (latitude in longitude) ter opis (lokacije, senzorjev/naprav)

Če namesto ene izmed zgornjih lokacij napišemo "all", se prikažejo zadnji podatki vseh trenutnih postaj.

http://www.matvoz.com/idrija/api/sendinfo.php?location=all

Če namesto ene izmed zgornjih lokacij napišemo "all24", se prikažejo podatki zadnjih 24 ur vseh trenutnih postaj.

http://www.matvoz.com/idrija/api/sendinfo.php?location=all24

Arduino sketch izsek za dostop do APIja

Sketch ogrodje je na voljo tukaj.

Zadnja sprememba strani: 19.02.2017