Obsah
Export posledního měření
Pokud chceme poslední měření dále zpracovávat a z TMEP.cz získávat, není to problém. V menu u konkrétního čidla zvolte „Export posledního měření“ a dostanete se na stránku s odkazy pro export hodnot včetně náhledu na to, co vrací. Zvolit můžeme buď formát JSON, nebo XML.
Na stránce exportu posledního měření u konkrétního čidla v administraci TMEPu vidíte několik druhů exportů včetně náhledu aktuálních hodnot.
Krátký JSON
Dostaneme adresu ve tvaru (JSON):
http://tmep.cz/vystup-json.php?id=1&export_key=test
Nebo (XML):
http://tmep.cz/vystup-XML.php?id=1&export_key=test
Proměnná export_key
je důležitá - bez její správné hodnoty nedojde k exportu.
Výsledný export ke zpracování ve formátu JSON vypadá takto:
{ "teplota": 21.6, "vlhkost": 42.7, "cas": "2020-11-09 07:36:32", "umisteni": "V místnosti.", "nadpis": "Teploměr na firmě", "domena": "teplomerfirma.tmep.cz" }
Rozšířený JSON
U JSONu je možné využít i rozšířený výpis o denní minima a maxima u teploty a vlhkosti a případnou hodnotu tlaku/CO2 (vždy pod „tlak“). Stačí do URL s výstupem JSONu přidat parametr „&extended=1“, např.:
http://tmep.cz/vystup-json.php?id=1&export_key=test&extended=1
Výpis poté vypadá takto:
{ "teplota": 22.1, "vlhkost": 40.8, "tlak": null, "teplota_jednotka": "°C", "vlhkost_jednotka": "%", "tlak_jednotka": "hPa", "cas": "2022-12-12 10:24:05", "umisteni": "V místnosti.", "nadpis": "Teploměr na firmě", "domena": "teplomerfirma.tmep.cz", "nejnizsiTeplota": 18.4, "nejvyssiTeplota": 22.2, "nejnizsiVlhkost": 38.2, "nejvyssiVlhkost": 42.9, "nejnizsiTlak": null, "nejvyssiTlak": null, "rssi": null, "napeti": null }
V případě rozšířeného exportu u čidlu typu „Spotřeba“ jsou navíc přítomné položky „spotreba_dnes“ a „spotreba_celkem“.
JSON export hodnot ze všech čidel
Pokud chcete, můžete si nechat vrátit export dat ze všech čidel pod vaším účtem a to buď v běžném nebo rozšířeném výpisu. Hodnota export_key je jiná a místo pro konkrétní čidlo je vyplněná ta pro daného uživatele. Součástí výpisu je vždy nadřazený uzel s neměnným ID čidla.
URL pak vypadá pro běžný výpis všech čidel takto:
http://tmep.cz/vystup-json.php?id=1&export_key=test&all=1
A pro rozšířený výpis takto:
http://tmep.cz/vystup-json.php?id=1&export_key=test&extended=1&all=1
Ukázka výpisu:
{ "1": { "teplota": 15, "vlhkost": 72, "tlak": 993, "cas": "2022-12-12 10:14:02", "domena": "test.tmep.cz", "rssi": null, "napeti": null }, "3032": { "teplota": 22, "vlhkost": 67, "tlak": 994, "cas": "2022-12-12 10:18:03", "domena": "tradadatest.tmep.cz", "rssi": -53, "napeti": null } }
JSON rozšířený navíc o varování CHMI
Chcete-li exportovat i varovná hlášení z Českého hydrometeorologického ústavu, pak u čidla nezapomeňte vyplnit do jaké obce s rozšířenou působností spadá. Do URL s výstupem JSONu přidejte parametr „&chmi=1“, např.:
http://tmep.cz/vystup-json.php?id=1&export_key=test&extended=1&chmi=1
Pod parametrem „chmi“ naleznete buď „null“ (nejsou žádná varování), string „Čidlo nemá nastavený kód obce!“, nebo pole s varováními, kdy každé varování (může jich být více najednou - vysoké teploty, bouřky…) má položky:
awareness_level
- Úroveň důležitosti varování, nabývá hodnotinfo
,yellow
,green
,orange
nebored
.event
- Krátký název události.description
- Delší popis o co se jedná.eventEndingTime
- Kdy událost končí nebo do kdy je platné hlášení. Po překročení času se událost přestane vracet v JSONu.
{ "teplota": null, "vlhkost": null, "tlak": 982.1, "teplota_jednotka": "°C", "vlhkost_jednotka": "%", "tlak_jednotka": "hPa", "cas": "", "umisteni": null, "nadpis": null, "domena": ".datlog.cz", "nejnizsiTeplota": -0.3, "nejvyssiTeplota": 15.9, "nejnizsiVlhkost": 51, "nejvyssiVlhkost": 69, "nejnizsiTlak": 980.8, "nejvyssiTlak": 983.9, "rssi": null, "napeti": null, "chmi": [ { "awareness_level": "yellow", "event": "Silné bouřky", "description": "Mohou se vyskytnout silné bouřky doprovázené nárazy větru kolem 20 m\/s (70 km\/h), kroupami a přívalovými srážkami s krátkodobými úhrny kolem 30 mm.", "eventEndingTime": "2023-06-16 21:00:00" } ] }
XML
<?xml version="1.0" encoding="iso-8859-1"?> <root xmlns="http://www.papouch.com/xml/th2e/act"> <sns id="1" type="1" status="0" unit="0" val="27.6" w-min="" w-max="" e-min-val="26.8" e-max-val="29" e-min-dte="06/22/2018 00:00:00" e-max-dte="06/22/2018 00:00:00"/> <sns id="2" type="2" status="0" unit="3" val="31" w-min="" w-max="" e-min-val="26.7" e-max-val="43.7" e-min-dte="06/22/2018 00:00:00" e-max-dte="06/22/2018 00:00:00"/> <sns id="3" type="3" status="0" unit="0" val="8.9" w-min="" w-max="" e-min-val="" e-max-val="" e-min-dte="" e-max-dte=""/> <status frm="1" location="Na zahradě" time="06/22/2018 09:43:13"/> </root>
XML formát je kompatibilní s Gadgetem od Papoucha, takže si můžete nechat jednoduše zobrazit poslední naměřenou teplotu na ploše počítače: https://www.papouch.com/cz/website/mainmenu/software/windows-gadget-teplomer/
Příklady jak s tímto dále pracovat naleznete zde: Získání poslední hodnoty na webu