Adatvédelmi tájékoztatónkat itt találod. A minőségi szolgáltatás érdekében sütiket használunk.
ELFOGADOM
Menü ≡

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

2010.11.09. | Frissítve: 2018.04.09.
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
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.

Verzió 2.3 - 2018. 10. 10.

A két napos időjárás előrejelzést helyett már 4 napos előrejelzést szolgáltatunk.

Verzió 2.4 - 2019. 04. 09.

A 4 napos időjárás előrejelzést helyett már 7 napos előrejelzést szolgáltatunk.
Ha kérdésed van, fordulj hozzánk a sielok@sielok.hu címen.
h i r d e t é s
h i r d e t é s
h i r d e t é s
UTASBIZTOSÍTÁS -10% » SÍELŐK NAPTÁRA »
FELIRATKOZÁS HÍRLEVÉLRE »
A SIELOK.HU SZÁMOKBAN
A portált jelenleg 114 vendég és 7 regisztrált felhasználó látogatja.