Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- portal:export_posledniho_mereni [2018/06/22 09:45] – multitricker
+++ portal:export_posledniho_mereni [2023/03/20 08:44] (aktuální) – multitricker
@@ Řádek 1: / Řádek 1: @@
 ====== Export posledního měření ======
-{{ :portal:pasted:20160307-111937.png?150}}
+{{ :portal:pasted:20220817-154210.png?200}}
-Pokud chceme poslední měření dále zpracovávat a z TMEP.cz získávat, stačí jej stahovat z adresy, kterou dostaneme po najetí na "Poslední měření" v menu čidla. Zvolit můžeme buď formát JSON, nebo XML.
+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.
-Následně dostaneme adresu ve tvaru (JSON):
+**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.**
-''http://tmep.cz/vystup-json.php?id=1&export_key=test''
-Nebo (XML):
+===== 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á následovně:
+Výsledný export ke zpracování ve formátu JSON vypadá takto:
 <code javascript>
 {
-   "teplota": 21.3,
+  "teplota": 21.6,
-   "vlhkost": 65.9,
+  "vlhkost": 42.7,
-   "cas": "2016-01-31 09:42:32",
+  "cas": "2020-11-09 07:36:32",
-   "umisteni": "Na altánku"
+  "umisteni": "V místnosti.",
+  "nadpis": "Teploměr na firmě",
+  "domena": "teplomerfirma.tmep.cz"
 }
 </code>
-Formát XML takto:
+===== 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:
+<code javascript>
+{
+    "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
+}
+</code>
+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:
+<code javascript>
+{
+    "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
+    }
+}
+</code>
+===== 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á hodnot ''info'', ''yellow'', ''green'', ''orange'' nebo ''red''.
+  * ''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.
+<code javascript>
+{
+  "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"
+    }
+]
+}
+</code>
+===== XML =====
 <code xml>
 <?xml version="1.0" encoding="iso-8859-1"?>