Hójelentés, időjárás-jelentés xml leírás - 2.4 verzió

2010.11.09. 2020.01.05. | frissítve: 2020.01.05.

Ahogyan az tartalomszolgáltatásunkat leíró cikkünkben olvasható, többféle módon nyújtunk hójelentés, időjárás és síterep adat szolgáltatást. Ez a dokumentáció az xml szolgáltatásunkat használó partnereink programozói számára szükséges technikai információkat tartalmazza.

Az adatszolgáltatás elérése

A szolgáltatás a https://sielok.hu/partnerhojelentes/ címen érhető el regisztrált partnereink számára. A szolgáltatás elindításához következő adatokra van szükségünk:

IP címek listája, ahonnan a szolgáltatást igénybe veszik
Síterepek listája, melyekről jelentést küldünk
Hójelentés, időjárás, síterep adatok listája

Az IP címek listája tartalmazza annak a szervernek az IP címét, ahonnan a szolgáltatás igénybe vehető, és esetleg a fejlesztői gépek IP címeit.

A síterepek listáját a sielok.hu-n alkalmazott url formátumban kell leírni. Tehát ha valaki Eplény és Zermatt adatait szeretné kapni tőlünk, ezt a két url-t kell elküldenie:
https://sielok.hu/siterep/epleny/
https://sielok.hu/siterep/zermatt/

Ha a partner az adatokat a saját síterepeihez kapcsolva szeretné megjeleníteni, akkor arra van szükség, hogy a sielok.hu síterep azonosítókhoz a partner hozzá tudja rendelni a saját síterep azonosítóit. Ezt a programozó meg tudja oldani valami egyszerű tömbben vagy adatbázis táblában, mely a sielok.hu síterep azonosítóit, és a partner síterep azonosítóit tartalmazza. A sielok.hu síterep azonosítói az url-ben is láthatóak, pl. a fenti két síterep azonosítói: 'epleny', ill. 'zermatt'.
Ha a partner csak néhány síterep adatait jeleníti meg pl. egy dobozban, és ezek egy helyen jelennek meg a szájton, akkor erre az összerendelésre nincs szükség.

A hójelentés, időjárás, síterep adatok listáját a szerződésben megállapodottak szerint küldjük. Időjárás-jelentést a mai, holnapi és holnaputáni napról küldünk.

Az xml fájlbeli adattagok annak megfelelően jelennek meg, hogy milyen szerződés van a partner és a sielok.hu közt.

Alap adatok

Ez a négy adatmező mindig megjelenik:

siterep_azonosito_szam
siterep_azonosito_nev
siterep_nev
orszag_nev
regio_nev

Hójelentéshez kapcsolódó adatmezők:

ho_hegy
ho_volgy
siterep_nyitva
utolso_hoeses
hoadat_utolso_frissites
uzemelo_liftek_szama
uzemelo_palyak_hossza_km
hominoseg

Fontos: a zárva tartó síterepek általában nem szolgáltatnak hóadatot

Ha a 'siterep_nyitva' mező értéke 'nem', az azt jelenti, hogy a síterep nem tart nyitva, nem jelent hóadatokat. Ilyen esetben a 'ho_hegy', 'ho_volgy' értékei lehet, hogy nullát mutatnak, de ez nem azt jelenti, hogy a hegyen nincs hó, hanem hogy nem érkezik adat. Ilyenkor a programozó eldöntheti, hogy kiveszi-e az adott síterepet az általa mutatott hójelentésből, esetleg egy vonalkát tesz ki a síterephez kapcsolódó hóadat helyére, vagy épp az n.a. (nincs adat) rövidítést. Partnereink maguk választhatják ki a legjobb megoldást, mi a saját hójelentés listáinkban vonalat mutatunk, a síterep oldalán pedig az alábbi szöveget jelenítjük meg: "A síterep jelenleg nem üzemel, ezért nem szolgáltat hóadatokat".

Síterep adatokhoz kapcsolódó adatmezők:

magassag_hegy
magassag_volgy
szintkulonbseg
palya_hossz_km_ossz
palya_hossz_km_fekete
palya_hossz_km_piros
palya_hossz_km_kek
lift_szam_ossz
lift_szam_vonat
lift_szam_kabin
lift_szam_ulo
lift_szam_huzo
gps
palyaterkep_kicsi
palyaterkep_nagy

Az időjárás adatokhoz tartozó mezők az 'idojaras' szekción belül találhatóak.

Példa

Példa xml fájl két sítereppel, az elsőnél a hójelentés és a pályaadatok szerepelnek, a másodiknál szerepel időjárás jelentés is:

<?xml version="1.0" encoding="UTF-8" ?>
<hojelentes>

<siterep>
    <siterep_azonosito_szam>70</siterep_azonosito_szam>
    <siterep_azonosito_nev>epleny</siterep_azonosito_nev>
    <siterep_nev>Eplény</siterep_nev>
    <ho_hegy>30</ho_hegy>
    <ho_volgy>30</ho_volgy>
    <siterep_nyitva>igen</siterep_nyitva>
    <utolso_hoeses>2015-01-05</utolso_hoeses>
    <hoadat_utolso_frissites>2015-05-05</hoadat_utolso_frissites>
    <uzemelo_liftek_szama>3</uzemelo_liftek_szama>
    <uzemelo_palyak_hossza_km>3.1</uzemelo_palyak_hossza_km>
    <hominoseg>4</hominoseg>
    <magassag_hegy>530</magassag_hegy>
    <magassag_volgy>350</magassag_volgy>
    <szintkulonbseg>180</szintkulonbseg>
    <palya_hossz_km_ossz>4.3</palya_hossz_km_ossz>
    <palya_hossz_km_fekete>1.5</palya_hossz_km_fekete>
    <palya_hossz_km_piros>0.8</palya_hossz_km_piros>
    <palya_hossz_km_kek>2.0</palya_hossz_km_kek>
    <lift_szam_ossz>6</lift_szam_ossz>
    <lift_szam_vonat>0</lift_szam_vonat>
    <lift_szam_kabin>0</lift_szam_kabin>
    <lift_szam_ulo>1</lift_szam_ulo>
    <lift_szam_huzo>5</lift_szam_huzo>
    <orszag_nev>Magyarország</orszag_nev>
    <regio_nev>Bakony</regio_nev>
    <gps>47.21224,17.93247</gps>
    <palyaterkep_kicsi>
    https://sielok.hu/images/siterkepek/zz_epleny.jpg
    </palyaterkep_kicsi>
    <palyaterkep_nagy>
    https://sielok.hu/images/siterkepek/epleny.jpg
    </palyaterkep_nagy>
</siterep>

<siterep>
    <siterep_azonosito_szam>337</siterep_azonosito_szam>
    <siterep_azonosito_nev>zermatt</siterep_azonosito_nev>
    <siterep_nev>Zermatt</siterep_nev>
    <ho_hegy>120</ho_hegy>
    <ho_volgy>0</ho_volgy>
    <siterep_nyitva>igen</siterep_nyitva>
    <utolso_hoeses>2014-07-24</utolso_hoeses>
    <hoadat_utolso_frissites>2014-08-11</hoadat_utolso_frissites>
    <uzemelo_liftek_szama>13</uzemelo_liftek_szama>
    <uzemelo_palyak_hossza_km>23</uzemelo_palyak_hossza_km>
    <hominoseg>2</hominoseg>
    <magassag_hegy>3883</magassag_hegy>
    <magassag_volgy>1608</magassag_volgy>
    <szintkulonbseg>2275</szintkulonbseg>
    <palya_hossz_km_ossz>200.0</palya_hossz_km_ossz>
    <palya_hossz_km_fekete>50.0</palya_hossz_km_fekete>
    <palya_hossz_km_piros>117.0</palya_hossz_km_piros>
    <palya_hossz_km_kek>33.0</palya_hossz_km_kek>
    <lift_szam_ossz>35</lift_szam_ossz>
    <lift_szam_vonat>2</lift_szam_vonat>
    <lift_szam_kabin>14</lift_szam_kabin>
    <lift_szam_ulo>9</lift_szam_ulo>
    <lift_szam_huzo>10</lift_szam_huzo>
    <orszag_nev>Svájc</orszag_nev>
    <regio_nev>Wallis</regio_nev>
    <gps>46.020932,7.750223</gps>
    <palyaterkep_kicsi>
    https://sielok.hu/images/siterkepek/zz_zermatt.jpg
    </palyaterkep_kicsi>
    <palyaterkep_nagy>
    https://sielok.hu/images/siterkepek/zermatt.jpg
    </palyaterkep_nagy>
    <idojaras datum='2014-08-11'>
        <homerseklet_max_hegy>3</homerseklet_max_hegy>
        <homerseklet_min_hegy>-2</homerseklet_min_hegy>
        <homerseklet_max_volgy>20</homerseklet_max_volgy>
        <homerseklet_min_volgy>9</homerseklet_min_volgy>
        <szelerosseg_hegy>11</szelerosseg_hegy>
        <szelerosseg_volgy>7</szelerosseg_volgy>
        <idojaraskod_reggel_hegy>1</idojaraskod_reggel_hegy>
        <idojaraskod_delben_hegy>1</idojaraskod_delben_hegy>
        <idojaraskod_este_hegy>9</idojaraskod_este_hegy>
        <idojaraskod_reggel_volgy>1</idojaraskod_reggel_volgy>
        <idojaraskod_delben_volgy>1</idojaraskod_delben_volgy>
        <idojaraskod_este_volgy>8</idojaraskod_este_volgy>
    </idojaras>
    <idojaras datum='2014-08-12'>
        <homerseklet_max_hegy>2</homerseklet_max_hegy>
        <homerseklet_min_hegy>-2</homerseklet_min_hegy>
        <homerseklet_max_volgy>19</homerseklet_max_volgy>
        <homerseklet_min_volgy>8</homerseklet_min_volgy>
        <szelerosseg_hegy>22</szelerosseg_hegy>
        <szelerosseg_volgy>11</szelerosseg_volgy>
        <idojaraskod_reggel_hegy>1</idojaraskod_reggel_hegy>
        <idojaraskod_delben_hegy>2</idojaraskod_delben_hegy>
        <idojaraskod_este_hegy>9</idojaraskod_este_hegy>
        <idojaraskod_reggel_volgy>1</idojaraskod_reggel_volgy>
        <idojaraskod_delben_volgy>2</idojaraskod_delben_volgy>
        <idojaraskod_este_volgy>6</idojaraskod_este_volgy>
    </idojaras>
    <idojaras datum='2014-08-13'>
        <homerseklet_max_hegy>4</homerseklet_max_hegy>
        <homerseklet_min_hegy>0</homerseklet_min_hegy>
        <homerseklet_max_volgy>21</homerseklet_max_volgy>
        <homerseklet_min_volgy>9</homerseklet_min_volgy>
        <szelerosseg_hegy>22</szelerosseg_hegy>
        <szelerosseg_volgy>11</szelerosseg_volgy>
        <idojaraskod_reggel_hegy>1</idojaraskod_reggel_hegy>
        <idojaraskod_delben_hegy>2</idojaraskod_delben_hegy>
        <idojaraskod_este_hegy>9</idojaraskod_este_hegy>
        <idojaraskod_reggel_volgy>1</idojaraskod_reggel_volgy>
        <idojaraskod_delben_volgy>2</idojaraskod_delben_volgy>
        <idojaraskod_este_volgy>8</idojaraskod_este_volgy>
    </idojaras>
    <idojaras datum='2014-08-14'>
        <homerseklet_max_hegy>5</homerseklet_max_hegy>
        <homerseklet_min_hegy>1</homerseklet_min_hegy>
        <homerseklet_max_volgy>21</homerseklet_max_volgy>
        <homerseklet_min_volgy>9</homerseklet_min_volgy>
        <szelerosseg_hegy>22</szelerosseg_hegy>
        <szelerosseg_volgy>11</szelerosseg_volgy>
        <idojaraskod_reggel_hegy>1</idojaraskod_reggel_hegy>
        <idojaraskod_delben_hegy>2</idojaraskod_delben_hegy>
        <idojaraskod_este_hegy>9</idojaraskod_este_hegy>
        <idojaraskod_reggel_volgy>1</idojaraskod_reggel_volgy>
        <idojaraskod_delben_volgy>2</idojaraskod_delben_volgy>
        <idojaraskod_este_volgy>8</idojaraskod_este_volgy>
    </idojaras>
    <idojaras datum='2014-08-15'>
        <homerseklet_max_hegy>6</homerseklet_max_hegy>
        <homerseklet_min_hegy>2</homerseklet_min_hegy>
        <homerseklet_max_volgy>21</homerseklet_max_volgy>
        <homerseklet_min_volgy>9</homerseklet_min_volgy>
        <szelerosseg_hegy>22</szelerosseg_hegy>
        <szelerosseg_volgy>11</szelerosseg_volgy>
        <idojaraskod_reggel_hegy>1</idojaraskod_reggel_hegy>
        <idojaraskod_delben_hegy>2</idojaraskod_delben_hegy>
        <idojaraskod_este_hegy>9</idojaraskod_este_hegy>
        <idojaraskod_reggel_volgy>1</idojaraskod_reggel_volgy>
        <idojaraskod_delben_volgy>2</idojaraskod_delben_volgy>
        <idojaraskod_este_volgy>8</idojaraskod_este_volgy>
    </idojaras>
</siterep>

</hojelentes>

Az egyes elemek magától értetődőek, de itt egy kis segítség:

siterep_azonosito_szam : a sielok.hu-n használt azonosító szám. Ez használ a síterep azonosítására, és sosem változik.
siterep_azonosito_nev : a sielok.hu-n használt azonosító az url-ből. pl. zermatt, vagy epleny
siterep_nev: a síterep elnevezése a sielok.hu-n. Partnereink más elnevezést is használhatnak
ho_hegy, ho_volgy: Hó a hegyen illetve a völgyben centiméterben.
siterep_nyitva: lehetséges értékek: igen / nem
utolso_hoeses: az utolsó hóesés dátuma YYYY-MM-DD formátumban
hoadat_utolso_frissites: az a dátum, mikor a hójelentést utoljára frissítették a sielok.hu-n YYYY-MM-DD formátumban
uzemelo_liftek_szama: Azon felvonók száma, melyek épp üzemben vannak.
uzemelo_palyak_hossza_km: Azon pályák hossza kilométerben, melyek meg vannak épp nyitva a síelők számára
homerseklet_max_hegy: Az adott napon a maximális hőmérséklet a hegyen Celsius fokban. Negatív szám is lehet.
szelerosseg_volgy: Az adott napon várható szélerősség km/h-ban.
idojaraskod_reggel_hegy: Az adott napon reggel várható időjárás kódja. A kódok lentebb találhatóak.

Az alábbi adatok nem függnek a hótól, időjárástól, egy szezonban általában nem változnak

magassag_hegy: A síterep legmagasabb pontja méterben
magassag_volgy: A síterep legalacsonyabb pontja méterben
szintkulonbseg: Szintkülönbség méterben
palya_hossz_km_ossz: Pályák hossza összesen, kilométerben
palya_hossz_km_fekete: Fekete pályák hossza összesen, kilométerben
palya_hossz_km_piros: Piros pályák hossza összesen, kilométerben
palya_hossz_km_kek: Kék pályák hossza összesen, kilométerben
lift_szam_ossz: Liftek száma összesen
lift_szam_vonat: Vonat liftek száma összesen
lift_szam_kabin: Kabinos liftek száma összesen
lift_szam_ulo: Ülőliftek száma összesen
lift_szam_huzo: Húzóliftek száma összesen
orszag_nev: Az ország neve, melyben a síterep található
regio_nev: A régió neve, melyben a síterep található. Olyan országokban, ahol kevés a síterep nem tartunk nyilván régiót, itt ez az érték üres.

Időjárás kódok jelentése
1	napos
2	enyhén felhős
3	felhős
4	erősen felhős
5	borult
6	záporok
7	esős
8	zivatarok
9	hószállingózás
10	hóesés
11	havaseső
12	ködös
14	szemerkélő eső
99	nincs adat

Az időjárás ikonok letölthetőek innen. Kérjük az ikonok saját szerveren való elhelyezését.

Hóminőség (hominoseg) kódok jelentése
0	ismeretlen
1	porhó
2	friss hó
3	régi hó
4	műhó
5	kásás hó
6	firn hó
7	vizes hó
8	tömörített hó
9	tavaszi hó
10	nincs adat
11	lepel hó

Az xml fájl tükrözését óránkénti rendszerességgel ajánljuk.

Változások a specifikációban

Verzió 0.1 - 2010. 11. 10.

Kezdeti verzió

Verzió 0.2 - 2010. 11. 11.

Új elemek az xml-ben:
orszag_nev, pl: <orszag_nev>Magyarország</orszag_nev>
regio_nev: pl: <regio_nev>Bakony</regio_nev>

Verzió 1.0 - 2010. 12. 07.

Elindult az első éles megjelenítés a startlapon.

Verzió 2.0 - 2011. 08. 11.

Kibővült a szolgáltatás időjárás-jelentés adatokkal.

Verzió 2.1 - 2014. 12. 02.

Hóminőség adatokkal kiegészült a hójelentés

Verzió 2.2 - 2017. 12. 06.

A síterep azonosító szám is bekerült az xml-be: <siterep_azonosito_szam>70</siterep_azonosito_szam>
Ez nem változik akkor sem, ha esetleg a síterep nevében változás történik.