Időjárás-állomás csatlakoztatása a WindShare-hez

Az állomásod a Balaton minden vitorlázójának segíthet. A WindShare a mért szeledet megmutatja a vitorlázók térképén, és beépíti a helyi szélelőrejelzésbe. A hőmérséklet, a légnyomás és a csapadék is hasznosul. Néhány perc az egész: regisztráld az állomást, írj be két adatot az állomás alkalmazásába vagy programjába, aztán nézd meg, hogy megérkeznek-e a mérések.

In English: https://windshare-server.wittysmoke-181349cf.eastus.azurecontainerapps.io/pws/

Röviden

1. Regisztráld az állomásodat. Azonnal kapsz egy állomásazonosítót és egy állomáskulcsot.
2. Keresd meg az eszközödet a lenti táblázatban, és kövesd a hozzá tartozó leírást.
3. Ellenőrizd az állomásodat az állapotoldalon. Az első értékek néhány percen belül megjelennek.
4. Egy moderátor átnézi az állomást. Jóváhagyás után megjelenik a WindShare térképén.

Az állomás regisztrálása

Nyisd meg a regisztrációs oldalt, és töltsd ki:

Tipp: A koordinátákhoz nyomd hosszan a helyet a Google Térképen. A megjelenő két szám a szélesség és a hosszúság.

Az állomásnak a Balaton előrejelzési területeitől legfeljebb kb. 15 km-re kell lennie. A távolabbi állomásokat nem használjuk a tó szelénél.

Az űrlap elküldése után két adatot kapsz:

Megjegyzés: A kulcsot csak egyszer mutatjuk meg. Most mentsd el egy biztos helyre. Ha elveszted, írj a moderátornak, és újat kapsz.

Az állomáskulcs csak két dologra jó: elküldi ennek az egy állomásnak az adatait, és megnyitja az állomás saját állapotoldalát. Nem lehet vele belépni, semmilyen beállítást nem lehet vele módosítani, és senki személyes adatát nem mutatja meg, a tiédet sem. Ezért nyugodtan beírhatod olyan eszközbe is, amely titkosítás nélkül küldi. Ez nem egy fiók jelszava. Más hálózatok a fiókod jelszavát kérik helyette. Mi soha.

Az új állomás függőben állapotban indul. Ilyenkor a feltöltéseit fogadjuk és tároljuk, és az állapotoldalon követheted őket. A WindShare térképén és az előrejelzésben csak azután jelennek meg, hogy egy moderátor jóváhagyta az állomást. A moderátor ellenőrzi a helyszínt, az elhelyezést és azt, hogy hihetők-e az értékek, és WMO-elhelyezési osztályt (1–5) ad az állomásnak. Egy állomást egyes mennyiségekre használhatunk, másokra nem. Egy szélárnyékos szélmérő mellett például a hőmérséklet és a légnyomás még lehet jó.

Ha egy függőben lévő állomás 14 napig semmit nem küld, töröljük. Ha elkészült az állomás, regisztráld újra.

Kétféle csatlakozás

A közvetlen feltöltés háromféleképpen működik. Hogy melyiket használod, az eszközödön vagy a programodon múlik:

• Weather Underground protokoll. A legtöbb konzol, wifis átjáró és meteorológiai program tud Weather Underground formátumban saját szerverre küldeni. A legtöbb állomás ezen az úton csatlakozik.
• Ecowitt protokoll. Az Ecowitt és más Fine Offset átjárók saját formátuma, kicsit több adattal.
• WindShare API. Saját programokhoz, adatgyűjtőkhöz és szkriptekhez, metrikus mértékegységekkel. Lásd: saját program és API.

Melyik alkalmazással vagy eszközzel állítod be az állomásodat?

Az állomás kézikönyvében vagy dobozán általában szerepel, melyik alkalmazással kell beállítani a wifit. Ez dönti el, melyik leírás kell neked.

Ecowitt és WS View Plus

A Fine Offset családhoz: Ecowitt, Froggit, Sainlogic, Eurochron (Conrad), Alecto, Ventus, Misol, valamint több Sencor, Gogen és Garni típus. A tó körül ez a leggyakoribb állomásfajta.

A Customized (egyéni) feltöltés beállításait így éred el:

1. WS View Plus: My Devices → válaszd ki az állomásodat → More → Weather Services → lapozz a Customized oldalra.
2. Ecowitt alkalmazás: nyisd meg az állomást → jobb felső menü → Others → DIY Upload Servers → Customized.
3. Az átjáró weboldala (GW1100, GW1200, GW2000, GW3000, valamint WS3900 vagy HP2560 konzol): írd be az eszköz IP-címét egy böngészőbe ugyanazon a wifin → Weather Services → görgess le a Customized részhez.

Ezután töltsd ki a mezőket. A két protokoll közül egyet válassz:

Nyomd meg a Save gombot (az alkalmazásokban fent, a weboldalon alul). Utána ellenőrizd az állomásodat. Az első értékek néhány percen belül megjelennek.

A példaadatokkal az Ecowitt útvonal így néz ki:

/pws/ecowitt/WS4K7Q2M/k7m2q9x4h3c8v6tp

Megjegyzés: A szervernevet kisbetűvel írd, http:// és záró / nélkül. Wunderground módban az útvonal végén ott kell lennie a ? jelnek, mert ezek az eszközök közvetlenül utána fűzik az adatokat.

Melyik protokollt válaszd?

• Az Ecowitt valamivel több adatot küld, például az állomásszinti (abszolút) légnyomást és a konzol 10 perces átlagait. Az azonosító és a kulcs az útvonalba kerül, mert ennek a protokollnak nincs külön mezője hozzájuk.
• A Wunderground minden Fine Offset utángyártott eszközön működik, régebbi firmware-rel is.

Bármelyik jó. Az eszközön egyetlen Customized hely van, így az állomás csak az egyik módon küld a WindShare-nek.

A Customized feltöltés a Weather Underground, az Ecowitt.net és a Weathercloud mellett fut. Egyikről sem kell lemondanod.

Tipp: Nincs Customized oldal? Frissítsd az állomás firmware-ét az alkalmazásból, és magát az alkalmazást is. A régebbi firmware-ekből hiányzik ez a lehetőség.

Ezek az állomások a csapadékot utolsó órás és éjfél óta mért összegként küldik, 24 órás összeget nem.

WSLink állomások

A WSLink alkalmazással beállított állomásokhoz: Sencor SWS 12500 és SWS 10500, a Garni Arcus család és több Bresser wifis állomás.

1. Nyisd meg az állomást a WSLinkben, és a beállításai között keresd meg az időjárás-szervereket. A Weather Underground és a Weathercloud mellett van egy egyéni (saját) szerver lehetőség. Egyes Garni típusoknál ez az eszköz saját beállítóoldalán van, a User's own server résznél.
2. Protokoll: Wunderground. Ha van „WSLink” protokoll jelölőnégyzet, vedd ki a pipát.
3. Szerver: windshare-pws.wittysmoke-181349cf.eastus.azurecontainerapps.io
4. Útvonal: /weatherstation/updateweatherstation (itt nincs ? a végén, az Ecowitt-tel ellentétben).
5. Station ID: az állomásazonosítód. Station key vagy jelszó: az állomáskulcsod.
6. Port: 80.
7. Mentsd el, majd ellenőrizd az állomásodat.

Ha az alkalmazás külön mezők helyett egyetlen teljes címet kér, ezt írd be:

http://windshare-pws.wittysmoke-181349cf.eastus.azurecontainerapps.io/weatherstation/updateweatherstation.php

Tipp: Nincs egyéni szerver lehetőség? Frissítsd az állomás firmware-ét a WSLinkben. Ha utána sincs, a konzol nem tud közvetlenül nekünk küldeni. Egy kis közvetítő program, például WeeWX egy Raspberry Pi-n, kiolvashatja és továbbküldheti az adatait (lásd: meteorológiai programok).

Meteorológiai programok

Minden program, amely „Wunderground-kompatibilis saját szerverre” tud küldeni, ezekkel a beállításokkal működik:

A szerver a Weather Undergroundhoz hasonlóan success választ ad, így a választ ellenőrző programok is elégedettek.

WeeWX

A weewx.conf fájlban irányítsd a Wunderground feltöltőt a WindShare-re:

[StdRESTful]
    [[Wunderground]]
        enable = true
        station = WS4K7Q2M
        password = k7m2q9x4h3c8v6tp
        server_url = http://windshare-pws.wittysmoke-181349cf.eastus.azurecontainerapps.io/weatherstation/updateweatherstation.php
        rapidfire = False

Indítsd újra a WeeWX-et, és figyeld a naplóját: minden feltöltés után sikeres sornak kell jönnie. Az opciók nevét a saját WeeWX-verziód dokumentációjában ellenőrizd. A beépített [[Wunderground]] szakasz csak egy szerverre küld. Ha már a Weather Undergroundot táplálja, hagyd úgy, és a WindShare-t egy második feltöltő bővítménnyel add hozzá.

Meteobridge

Használj olyan push szolgáltatást, amely percenként HTTP kérést küld (Services → Push Services → HTTP request). A cél a saját program és API résznél leírt metrikus URL-sablon, az értékek helyén a Meteobridge sablonváltozóival. Például:

https://windshare-server.wittysmoke-181349cf.eastus.azurecontainerapps.io/pws/v1/upload?id=WS4K7Q2M&key=k7m2q9x4h3c8v6tp&wind_speed_ms=[wind0avgwind-act]&wind_gust_ms=[wind0wind-max1]&wind_dir_deg=[wind0dir-act]&air_temp_c=[th0temp-act]&rel_humidity_pct=[th0hum-act]&pressure_station_hpa=[thb0press-act]&rain_day_mm=[rain0total-daysum]

A fenti változónevek csak példák. Az érzékelőidhez illő neveket nézd meg a Meteobridge sablondokumentációjában. A Meteobridge alapból metrikus mértékegységekkel dolgozik.

CumulusMX

A Settings → Third Party → Custom HTTP résznél kapcsold be a Custom HTTP Seconds lehetőséget (pl. 60 másodpercenként), és add meg a metrikus URL-sablont a Cumulus web tagjeivel. Például:

https://windshare-server.wittysmoke-181349cf.eastus.azurecontainerapps.io/pws/v1/upload?id=WS4K7Q2M&key=k7m2q9x4h3c8v6tp&wind_speed_ms=<#wspeed rc=y>&wind_gust_ms=<#wgust rc=y>&wind_dir_deg=<#bearing>&air_temp_c=<#temp rc=y>&rel_humidity_pct=<#hum>&pressure_msl_hpa=<#press rc=y>&rain_day_mm=<#rfall rc=y>&rain_rate_mmh=<#rrate rc=y>

• A Cumulusban a szél mértékegysége legyen m/s, a hőmérsékleté °C, a légnyomásé hPa, a csapadéké mm. Ha nem így van, a sablonban kell átszámolni.
• Az rc=y a tizedesvesszőt pontra cseréli. Magyar nyelvű rendszeren erre feltétlenül szükség van.
• Ha a szél átlagolási ideje 10 perc, add hozzá: &wind_avg_s=600.
• A web tagek nevét a saját verziód CumulusMX dokumentációjából vedd. A fentiek csak példák.

Weather Display, Meteohub és a többiek

Keress custom vagy Wunderground-kompatibilis szerverbeállítást, és használd a szakasz elején lévő táblázat értékeit. A Meteohub a saját program és API résznél leírthoz hasonló egyéni HTTP-sablonnal is tud küldeni.

Davis állomások

A Davis Vantage Pro2, a Vantage Vue, a WeatherLink Live és az EnviroMonitor önmagában nem tud saját szerverre küldeni, csak a WeatherLink.com-ra. Ha most szeretnéd csatlakoztatni, használj közvetítőt:

• Meteobridge, Davis USB-s vagy soros adatgyűjtővel, majd a Meteobridge beállítások. A WeatherLink Live támogatását nézd meg a Meteobridge hardverlistájában.
• WeeWX, WeatherLink Live meghajtóval vagy Davis adatgyűjtővel, majd a WeeWX beállítások.
• CumulusMX, amely a Vantage adatgyűjtőket és a WeatherLink Live-ot is olvassa, majd a CumulusMX beállítások.

A WeatherLink.com-ról vagy a Weather Undergroundról való közvetlen áttöltés tervben van, de még nem elérhető.

Netatmo

A Netatmo állomások nem tudnak más szerverre feltölteni. A Netatmo-csatlakozás, amely a Netatmo saját felületén keresztül olvasná ki az adataidat, tervben van, de még nem elérhető.

A legtöbb Netatmo szélmérő alacsonyan, egy rúdon vagy korláton, épületek közelében áll. Ezért a moderátor a csatlakozás elkészülte után is gyakran csak a hőmérsékletét és a légnyomását használja majd, a szelét nem.

Saját program és API

Adatgyűjtőkhöz, szkriptekhez és fejlesztőknek. Metrikus mértékegységekkel dolgozik, és az átlagokat úgy küldheted, ahogy te számolod őket.

URL-sablon (GET vagy POST)

Olyan programokhoz, amelyek csak URL-t tudnak összeállítani:

https://windshare-server.wittysmoke-181349cf.eastus.azurecontainerapps.io/pws/v1/upload?id=WS4K7Q2M&key=k7m2q9x4h3c8v6tp&wind_speed_ms=5.2&wind_gust_ms=8.1&wind_dir_deg=230&air_temp_c=12.3&rel_humidity_pct=71&pressure_msl_hpa=1015.1

Ugyanez a sablon titkosítatlan HTTP-n is működik a HTTPS-re képtelen eszközökhöz, a http://windshare-pws.wittysmoke-181349cf.eastus.azurecontainerapps.io/pws/v1/upload címen. POST-tal a mezők űrlapként kódolt törzsben is jöhetnek.

JSON API

POST https://windshare-server.wittysmoke-181349cf.eastus.azurecontainerapps.io/pws/v1/observations, HTTP Basic hitelesítéssel: a felhasználónév az állomásazonosító, a jelszó az állomáskulcs.

curl -u WS4K7Q2M:k7m2q9x4h3c8v6tp \
  -H "Content-Type: application/json" \
  -d '{"observations":[{"time":"2026-11-13T10:20:00Z","wind_speed_ms":5.2,"wind_gust_ms":8.1,"wind_dir_deg":230,"wind_avg_s":600,"gust_s":3,"air_temp_c":12.3,"rel_humidity_pct":71,"pressure_msl_hpa":1015.1}]}' \
  https://windshare-server.wittysmoke-181349cf.eastus.azurecontainerapps.io/pws/v1/observations

• Kérésenként legfeljebb 100 mérés küldhető.
• A mérések legfeljebb 48 órásak lehetnek, így egy kiesés után az adatgyűjtő pótolhatja a lemaradást.
• A válasz megmondja, hány mérést fogadtunk el, és miért utasítottunk el egyet-egyet:

{"status":"ok","station_id":"WS4K7Q2M","station_status":"pending","accepted":1,"stored":1,"rejected":[]}

Az elutasított mérés {"index": i, "reason": "..."} alakban szerepel, ahol az index a sorszáma a tömbödben. Ha egyik mérés sem használható, a válasz 400, ugyanezzel a listával. A stored kisebb lehet az accepted értéknél: az egy percen belüli feltöltéseket egy rekorddá vonjuk össze (lásd: így ellenőrizzük az adatokat). Egy mérés időbélyege legfeljebb 2 perccel járhat a szerver órája előtt.

Mezők

Minden mező elhagyható. Amit nem mérsz, azt egyszerűen hagyd ki.

Válaszok

Az URL-sablon és a JSON API ugyanazokkal a HTTP-állapotkódokkal válaszol:

WMO szerinti mérés

Ha az adatgyűjtőd ki tudja számolni, azt küldd, amit a Meteorológiai Világszervezet (WMO-No. 8) meghatároz:

• 10 perces átlagszél, wind_avg_s=600 értékkel, kerek tíz percekre végződve (óó:00, óó:10, …).
• 3 másodperces széllökés (az időszak legnagyobb 3 másodperces mozgóátlaga), gust_s=3 értékkel.
• Az irányt vektoriálisan átlagold: a szél keleti és északi összetevőjét átlagold, soha ne a szögeket. 350° és 10° átlaga 0°, nem 180°.
• Elég, ha a magasságokat a regisztrációnál megadod. A sebességet ne számold át magad 10 méterre.

Az állomás ellenőrzése

Az állapotoldalon van egy Állomásom ellenőrzése rész. Add meg az állomásazonosítót és a kulcsot, és ezeket látod:

• az állomás állapotát: függőben, aktív vagy felfüggesztett;
• mikor érkezett az utolsó feltöltés, és milyen protokollt és programot ismert fel a szerver;
• az utolsó értékeket úgy, ahogy a szerver értelmezte őket, metrikus mértékegységekben;
• az esetleges minőségi jelzéseket, például hibás órát, tartományon kívüli értéket, vagy az átlagszélnél kisebb széllökést;
• az eszközöd által küldött nyers mezők nevét, a hitelesítő adatok nélkül.

Ha valami nem stimmel, mindig ez az első lépés. Ha az oldal egyáltalán nem mutat feltöltést, az eszköz nem éri el a szervert: ellenőrizd a szervernevet, az útvonalat, a portot és a kulcsot. Ha vannak feltöltések, de furcsák az értékek, nézd meg a mértékegységeket és az elhelyezést.

Az érzékelők elhelyezése

A jó elhelyezés többet számít a drága érzékelőnél. Ezek a szabályok a WMO útmutatóját (WMO-No. 8) követik. Tökéletes hely ritkán adódik: tedd meg, amit lehet, a többit pedig írd le őszintén a regisztrációnál.

Szél

• Ideálisan 10 méterrel nyílt terep felett, ez a nemzetközi szabványmagasság.
• Az akadályoktól legalább a magasságuk tízszeresére legyen. Egy 5 méteres fától tehát legalább 50 méterre.
• A tóparton a legjobb egy árboc vagy egy mólóvég, ahonnan szabadon rálát a vízre. Ez az a szél, amelyben a vitorlázók vitorláznak.
• Tetőn a szélmérőt legalább 2–3 méterrel a gerinc vagy a legmagasabb közeli akadály fölé tedd. A tető közelében zavart az áramlás.
• A valódi magasságot add meg. Rögzítjük, és nem „javítjuk” vele a sebességet, így az előrejelzés figyelembe veheti.
• Az ultrahangos érzékelők (pl. Ecowitt WS80, WS90) is megfelelők.

Hőmérséklet és páratartalom

• 1,25–2 méterrel a talaj felett, fű vagy természetes talaj fölött.
• Szellőző sugárzásvédő ernyőben (zsalus vagy Stevenson-féle hőmérőházban). Soha ne közvetlen napon.
• Ne aszfalt vagy burkolat fölött, ne tetőn, és távol a falaktól, ablakoktól, kéményektől és a klíma kifúvójától.
• Az olcsó, egybeépített érzékelők kis műanyag ernyője napsütésben és szélcsendben felmelegszik. Egy külön, jobb sugárzásvédő sokat javít.

Légnyomás

• A regisztrációnál pontos terepmagasságot adj meg.
• Ha az eszköz állomásszinti (abszolút) légnyomást is küld, mint az Ecowitt, azt használjuk, és mi számoljuk át tengerszintre.
• Ha nem, a relatív légnyomást egy nyugodt, szélcsendes napon kalibráld a legközelebbi hivatalos állomáshoz (HungaroMet, met.hu).

Csapadék

• A csapadékmérő legyen vízszintes, a pereme 0,5–1,5 méterrel a talaj felett.
• A peremtől húzott 45°-os vonal fölé semmi ne nyúljon be. Egy akadálytól legalább a magassága kétszeresére legyen, ideálisan négyszeresére.
• A tölcsért rendszeresen tisztítsd. A levelek és a rovarok eltömítik.

Napsugárzás, UV és víz

• Napsugárzás és UV: egész nap árnyékmentesen, vízszintesen.
• Vízhőmérséklet: úszó szonda (pl. Ecowitt WN34) 10–30 cm-rel a felszín alatt, távol a part sekély szélétől, a naptól árnyékolva.

Így ellenőrizzük az adatokat

Minden feltöltést ellenőrzünk, mielőtt eltároljuk:

Így állnak össze a mérések:

• Percenként egy rekord. A gyorsabb feltöltéseket (RapidFire, valós idejű, 5–16 másodperces) is fogadjuk, és a szerver percenként egy rekorddá vonja össze őket. A szelet vektoriálisan átlagoljuk, a legnagyobb széllökést megtartjuk. A sűrűbb feltöltéstől tehát nem lesz „jobb” az állomásod a térképen: 60 másodperc bőven elég.
• 10 perces rekordok, a WMO órájához igazítva (óó:00, óó:10, óó:20, …). Ezek kerülnek az előrejelzésbe, mindegyik mellett a mögötte álló mérések számával.

A moderátor szerepe:

• Jóváhagyás után a moderátor WMO-elhelyezési osztályt ad minden állomásnak, 1-től (legjobb) 5-ig. Az előrejelzés ez alapján súlyozhatja az állomásokat.
• Egy állomást minden mennyiségre csak ott használunk, ahol arra alkalmas. Egy szélárnyékos szélmérő szelét kihagyhatjuk, miközben a hőmérsékletét és a légnyomását használjuk.

Kérdések és hibaelhárítás

Nincs Customized oldal az alkalmazásban

Frissítsd az állomás firmware-ét az alkalmazásból, és az alkalmazást is. A régebbi firmware-ekből hiányzik ez a lehetőség.

Az állapotoldal nem mutat feltöltést

• Útvonal: Ecowitt eszközön Wunderground módban az útvonal ?-re végződik: /weatherstation/updateweatherstation.php?. WSLinkben nincs ?: /weatherstation/updateweatherstation.
• Szervernév: csak windshare-pws.wittysmoke-181349cf.eastus.azurecontainerapps.io, http:// és záró / nélkül.
• Kulcs: a kulcs kisbetűkből és számjegyekből áll, pontosan úgy írd be. Az állomásazonosítónál mindegy a kis- és nagybetű.
• Csak HTTP: sok konzol nem tud HTTPS-t. Használd a windshare-pws.wittysmoke-181349cf.eastus.azurecontainerapps.io címet a 80-as porttal. A fő szervercím (https://windshare-server.wittysmoke-181349cf.eastus.azurecontainerapps.io) csak HTTPS-t fogad.

Az eszköz naplójában INVALIDPASSWORDID áll

Hibás az állomásazonosító vagy a kulcs. Másold be újra a jegyzeteidből, vagy kérj új kulcsot a moderátortól.

Az állomásom még mindig függőben van

Az új állomások a moderátor ellenőrzésére várnak. Az adataidat közben tároljuk, semmi nem vész el. Ha néhány napnál tovább tart, írj nekünk.

Nem látszik a szelem a térképen

Nézd meg az állapotoldalt. Lehet, hogy a moderátor az elhelyezés miatt kihagyta az állomás szelét. Az is lehet, hogy egyszerűen szélcsend van, és a nulla is érvényes mérés.

Furcsa a légnyomás

Többnyire hibás a terepmagasság, vagy a relatív légnyomást sosem kalibrálták. Lásd: légnyomás, és írd meg a moderátornak a helyes magasságot.

Miért nincs 24 órás csapadékösszeg?

A legtöbb konzol csak utolsó órás és éjfél óta mért összeget küld, ezért ezeket használjuk.

Milyen gyakran töltsön fel az állomás?

A 60 másodperc ideális. 5 másodperc és 10 perc között bármi működik.

Küldhetek továbbra is a Weather Undergroundra vagy a Weathercloudra?

Igen. A WindShare feltöltés mellettük fut.

Áthelyeztem az állomást

Írd meg a moderátornak az új helyet, a magasságokat és a környezetet. Az áthelyezett állomást újra jóvá kell hagyni.

Adatvédelem és adathasználat

• Jóváhagyás után az állomás neve, helye és mérései nyilvánosak. Megjelennek a WindShare alkalmazásban, a WindShare verseny- és előrejelzési oldalain, és felhasználjuk őket a szélelőrejelzésben.
• A nevedet és az e-mail-címedet soha nem tesszük közzé. Csak az állomással kapcsolatban keresünk meg rajtuk.
• Az állomás és az adatai törlését a peter@synergocom.eu címen kérheted.
• Ennyi ideig őrizzük az adatokat: a percenkénti rekordokat kb. egy hónapig, a 10 perces rekordokat kb. két évig.

Elakadtál? Írj nekünk

Írj a peter@synergocom.eu címre, és küldd el:

• az állomásazonosítódat (a kulcsot soha);
• az eszközt és a használt alkalmazást vagy programot;
• hol akadtál el;
• egy képernyőképet az állapotoldalról.