Uživatelské nástroje

Nástroje pro tento web


portal:export_posledniho_mereni

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á 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.
{
  "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