Données Skiplan pour la récupération des données xml sur skiplan

Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
Montagne
Skiplan.com
Spécifications des fichiers de
données
Auteur
Pascal LESAGE
Diffusion
Confidentielle
Version
Date
Référence
Restreinte
2.2
7 décembre 2004
donnees-skiplan.doc
Publique
Ce document annule et remplace toute version précédente
Copyright © KEOSYS 2001-2004
1, Impasse Augustin Fresnel
44815 Saint-Herblain- FRANCE
Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans autorisation écrite de Keosys
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
Historique des versions
Version
Date
Auteur
Objet
1.0
10/11/2001
A. GRASSET
2.0
10/12/2001
L. LACROIX
2.1
14/12/2001
L. LACROIX
Documentation de la récupération du fichier XML
2.2
7/12/2004
P.LESAGE
Ajout des indices Skifrance dans le fichier XML
Création du document
Page 2 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
SOMMAIRE
1
PRESENTATION DES SCRIPTS .................................................................................................... 5
1.1
DESCRIPTION .............................................................................................................................. 5
1.2
CONSULTATION DEPUIS UN NAVIGATEUR ....................................................................................... 5
1.2.1
Fichier texte ....................................................................................................................... 5
1.2.2
Fichier XML........................................................................................................................ 5
1.3
PLANIFIER LA RECUPERATION AUTOMATIQUE DES INFORMATIONS (SOUS WINDOWS 2000) ............... 5
2
FORMAT DU FICHIER TEXTE...................................................................................................... 13
2.1
2.2
2.3
2.4
2.5
3
SECTION [PARAMETRES] ....................................................................................................... 13
SECTION [BULLETIN]............................................................................................................... 14
SECTION [PREVISIONS] .......................................................................................................... 14
SECTION [ETATS] .................................................................................................................... 15
EXEMPLE DE FICHIER DE DONNEES ............................................................................................. 16
FORMAT DU FICHIER XML.......................................................................................................... 18
3.1
EXEMPLE DE FICHIER ................................................................................................................. 18
3.2
BALISE STATION ..................................................................................................................... 20
3.3
BALISE PERIODE..................................................................................................................... 20
3.4
BALISE DATEINFO................................................................................................................... 20
3.5
BALISE METEO ........................................................................................................................ 21
3.5.1
Balise PARAMETRES ..................................................................................................... 21
3.5.2
Balise ZONE .................................................................................................................... 21
3.5.2.1
Balise VALRISQUE .................................................................................................. 21
3.5.2.2
Balise LIBRISQUE.................................................................................................... 21
3.5.2.3
Balise RSQ_REEL.................................................................................................... 21
3.5.2.4
Balise TEMERATURE .............................................................................................. 21
3.5.2.5
Balise NEIGE............................................................................................................ 21
3.5.2.6
Balise CUMUL .......................................................................................................... 22
3.5.2.7
Balise VENT ............................................................................................................. 22
3.5.2.8
Balise DIRECTION ................................................................................................... 22
3.5.2.9
Balise QUALITE ....................................................................................................... 22
3.5.2.10 Balise QLT_ID .......................................................................................................... 22
3.5.2.11 Balise VISIBILITE ..................................................................................................... 23
3.5.2.12 Balise CIEL ............................................................................................................... 23
3.5.2.13 Balise CIEL_ID ......................................................................................................... 23
3.5.2.14 Balise CIEL_ID_APM ............................................................................................... 23
3.5.2.15 Balise DERNIERE_CHUTE...................................................................................... 23
3.5.3
Balise BULLETINS .......................................................................................................... 24
3.5.4
Balise BULLETIN ............................................................................................................. 24
3.5.4.1
Balise LANGUE ........................................................................................................ 24
3.5.4.2
Balise LIGNE ............................................................................................................ 24
3.5.5
Balise PREVISIONS ........................................................................................................ 24
3.5.6
Balise PREVISION .......................................................................................................... 24
3.5.7
Balise INDICES................................................................................................................ 25
3.5.7.1
Balise SKIABILITE.................................................................................................... 25
3.5.7.2
Balise AMBIANCE .................................................................................................... 25
3.5.7.3
Balise RETOUR_SKI................................................................................................ 25
3.5.7.4
Balise ETAT_ROUTE ............................................................................................... 26
3.5.7.5
Balise PISTES_VERTES.......................................................................................... 26
3.5.7.6
Balise PISTES_BLEUES.......................................................................................... 26
3.5.7.7
Balise PISTES_ROUGES ........................................................................................ 26
3.5.7.8
Balise PISTES_NOIRES .......................................................................................... 26
3.5.7.9
Balise REMONTEES ................................................................................................ 26
3.5.7.10 Balise KM_SKI_NORDIQUE .................................................................................... 26
3.6
BALISE ETATS ......................................................................................................................... 27
3.6.1
Balise SECTEUR............................................................................................................. 27
3.6.2
Balise PISTE.................................................................................................................... 27
Page 3 / 28
Montagne
Documentation
3.6.3
3.6.4
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
Balise REMONTEE.......................................................................................................... 28
Balise LIAISON ................................................................................................................ 28
Page 4 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
1 Présentation des scripts
1.1 Description
Deux scripts sont à votre disposition pour récupérer les informations de votre station de ski sur le site
Internet : www.skiplan.com.
Le premier script vous permet de récupérer les informations sous la forme d'un fichier texte dont le
format est proche d'un fichier .ini windows. L'autre permet de récupérer un fichier XML.
1.2 Consultation depuis un navigateur
1.2.1 Fichier texte
Le script de génération du fichier de données va recueillir les données de votre station pour générer
un fichier texte regroupant l’ensemble de ces données.
Le script de génération est un script PHP situé à l’URL suivante :
http://www.skiplan.com/php/genererTxt.php
Il prend en paramètre :
$pays
$region
$station
$lang
le pays de la station
la région de la station
le nom de la station
le langage utilisé pour la génération (‘fr’ pour le français)
Ainsi pour générer le fichier de données de la station Tignes, on doit appeler l’URL complète
suivante :
http://www.skiplan.com/ php/genererTxt.php?pays=france&region=alpes&station=tignes&lang=fr
1.2.2 Fichier XML
Pour récupérer un fichier xml, le script à utiliser est le suivant :
http://www.skiplan.com/php/genererXml.php
Il prend en paramètre :
$pays
le pays de la station
$region
la région de la station
$station
le nom de la station
Ainsi pour générer le fichier de données de la station Tignes, on doit appeler l’URL complète
suivante :
http://www.skiplan.com/php/genererXml.php?pays=france&region=alpes&station=tignes
1.3 Planifier la récupération automatique des informations (sous
windows 2000)
Il est possible de récupérer ce fichier de données automatiquement à une fréquence fixe. Par
exemple : tous les jours à 8h, ou tous les quarts d'heure.
Pour cela, on utilise le planificateur de tâche de Windows2000 et un petit utilitaire (wget) qui permet
de récupérer des pages sur un site web.
Vous devez pour cela lancer le programme d'installation "donnees-skiplan.exe" fourni avec ce
document. L'installation de donnees-skiplan.exe est très simple. Il vous suffit d'exécuter le programme
donnees-skiplan.exe et de cliquer sur "suivant" dans toutes les étapes de l'assistant. Lorsque
Page 5 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
l'assistant vous demande de saisir le nom de votre station, reportez-vous aux instructions qui vous
sont données dans le mail accompagnant ce document.
Vous devez ensuite créer une nouvelle tâche planifiée. Pour cela, Ouvrez le planificateur de tâches de
windows : Menu démarrer, Programmes, Accessoires, Outils systèmes, Tâches planifiées. La fenêtre
suivante s'affiche. Double-cliquez alors sur "Création d'une tâche planifiée".
Cliquez ensuite sur suivant, à l'apparition de la fenêtre ci-dessous.
Dans la fenêtre suivante, l'assistant vous demande d'indiquer le programme que Windows éxécutera
pour accomplir la tâche. Cliquez ici sur le bouton "Parcourir…"
Page 6 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
Sélectionnez alors le fichier de commande "donnees-skiplan.bat" (pour le fichier texte) ou "xmlskiplan.bat" (pour le fichier xml) dans le dossier d'installation de donnees-skiplan.exe (c:\Program
files\donnees-skiplan\ par défaut) fourni avec ce document, et cliquez sur "Ouvrir".
Dans la fenêtre suivante, cliquez sur l'option "Tous les jours" et cliquez ensuite sur "Suivant"
Page 7 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
Dans la fenêtre suivante, sélectionnez l'heure à partir de laquelle la tâche doit s'effectuer ; ici 09H00.
La fenêtre suivante vous demande d'indiquer le nom et le mot de passe de l'utilisateur qui doit
effectuer cette tâche (l'administrateur de l'ordinateur dans notre cas).
Page 8 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
Dans la fenêtre suivante, cochez la case "Ouvrir les propriétés avancées de cette tâche".
La fenêtre suivante s'affiche.
Page 9 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Sélectionnez alors l'onglet "Plannification" et cliquez sur le bouton "Avancé…"
Page 10 / 28
Version 2.2
7 décembre 2004
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
Dans la fenêtre des options avancées de la planification, cochez la case "Répéter la tâche" et
déterminez la fréquence d'éxécution de la tâche (toutes les 15 min dans notre cas). Vous pouvez
égélement indiquer une heure de fin d'éxécution (18h par exemple)
Cliquez alors sur Ok, et fermez toutes les fenêtres que vous avez ouvertes lors de cette manipulation.
Page 11 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
Maintenant, Windows récupérera toutes les 15 minutes, les données de votre station sur skiplan.com.
Ces données sont sauvegardées dans le fichier : c:\program files\donnees-skiplan\donnees.txt si vous
avez choisi de récupérer le fichier texte, c:\program files\donnees-skiplan\donnees.xml si vous avez
choisi de récupérer le fichier XML.
Page 12 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
2 Format du fichier texte
2.1 Section [PARAMETRES]
Cette section présente les données météo des zones d’observation STATION et ALTITUDE de la
station.
Mot clé
ZONE
ALTITUDE
LIBRISQUE
Définition
Nom de la zone d’observation
Altitude (ou sous-titre)
Libellé du risque d’avalanche
RISQUE_REEL
TEMPERATURE
NEIGE
CUMUL
VENT
DIRECTION
Indique s’il y a un risque réel
d’avalanche (Flash avalanche
sur les zones météo d’infoneige)
Température en °C
Hauteur de neige fraîche en cm
Hauteur totale de neige
Vitesse du vent (Km/h)
Libellé de la direction du vent
QUALITE
Libellé de la qualité de la neige
Valeurs
Texte
Texte
« Risque faible »
« Risque limité »
« Risque marqué »
« Risque fort »
« Risque très fort »
1 (Risque réel) ou 0
-50 ≤ t° ≤ +50
000 ≤ fraîche ≤ 900
000 ≤ fraîche ≤ totale ≤ 900
0 ≤ v ≤ 150
« Nord »
« Nord Est »
« Est »
« Sud Est »
« Sud »
« Sud Ouest »
« Ouest »
« Nord Ouest »
Pour les versions d’infoneige
antérieures à la version 1.3A3 :
« Croûtée »
« Ventée »
« Soufflée »
« Normale »
« Poudreuse »
« Fondante »
« Glacée »
Pour la version d’infoneige
1.3A3 et supérieure
« Fraîche »
« Douce »
« Dure »
« Humide »
« De printemps »
VISIBILITE
Pourcentage de visibilité
0 - 25 - 50 - 75 ou 100
CIEL
Libellé de l’état du ciel le matin
« Soleil »
« Couvert »
« Nuageux »
« Pluie »
« Neige »
« Tempête »
Page 13 / 28
Montagne
Documentation
CIEL_APM
Skiplan.com
Spécifications des fichiers de
données
Libellé de l’état du ciel l’aprèsmidi
Version 2.2
7 décembre 2004
« Soleil »
« Couvert »
« Nuageux »
« Pluie »
« Neige »
« Tempête »
2.2 Section [BULLETIN]
Cette section présente le bulletin météo du jour (date de validité et contenu). Le format est le suivant :
DATEVAL= JJ/MM/AAAA
LIGNE1=ligne_1<CR>
LIGNE2= ligne_2<CR>
…
LIGNEi= ligne_i<CR>
Le nombre de lignes dépend du nombre de lignes du message (il peut être inférieur à 8). Les lignes
ne sont pas obligatoirement complétées à droite par des espaces.
2.3 Section [PREVISIONS]
Cette section présente les différents bulletins de prévision. Ils sont classés par ordre de validité (J+1
avant J+2, …). Le format est le suivant :
[PREVISIONS]
DATEVAL= JJ/MM/AAAA
LIGNE1=ligne_11<CR>
LIGNE2= ligne_12<CR>
…
LIGNEi= ligne_1i<CR>
DATEVAL= JJ/MM/AAAA
LIGNE1=ligne_21<CR>
LIGNE2= ligne_22<CR>
…
LIGNEi= ligne_2i<CR>
La date indiquée est la date de fin de validité du bulletin.
Le nombre de lignes dépend du nombre de lignes du message (il peut être inférieur à 8).
Les lignes ne sont pas obligatoirement complétées à droite par des espaces.
Page 14 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
2.4 Section [ETATS]
Cette section présente l’états des pistes, remontées et liaisons.
Celles-ci sont classées par secteur.
Le format est le suivant :
SECTEUR=NOM_SECTEUR<CR>
REMONTEE=NOM_REMONTEE1,ETAT,TYPE<CR>
REMONTEE=NOM_REMONTEE2, ETAT,TYPE<CR>
PISTE =NOM_PISTE1, ETAT,TYPE<CR>
PISTE =NOM_ PISTE2, ETAT,TYPE<CR>
LIAISON =NOM_LIAISON1, ETAT <CR>
LIAISON =NOM_ LIAISON2, ETAT <CR>
On retrouve ce bloc autant de fois que l’on trouve de secteurs.
Le champs ETAT indique l’état d’ouverture de la PRL (PRL pour Piste, Remontée, Liaison). Il peut
prendre les valeurs présentées dans la table suivante :
Etat
O
F
P
H
Description
Ouvert
Fermé
prévision d’ouverture
hors service
Le champs TYPE indique le type de la PRL. Voici les différentes valeurs que peut prendre le champs
‘TYPE’ :
Pour les pistes :
Etat
N
R
V
B
Description
Piste noire
Piste rouge
Piste verte
Piste bleue
Pour les remontées :
TYPE est l’identifiant du type de la remontée (CF tableau ci-dessous)
Type
A
F
B
S
L
FUNI
TB
TC
TPH
TS
TSD
TK
FNT
TR
Description
Ski Alpin
Ski de fond
Champ de bosse
Snow Park
Luge
Funiculaire
Télébenne
Télécabine
Téléphérique
Télésiège
Télésiège débrayable
Téléski
Funitel
Tapis roulant
Page 15 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
2.5 Exemple de fichier de données
[PARAMETRES]
ZONE=Station
ALTITUDE=1200
LIBRISQUE=Risque faible
RISQUE_REEL=0
TEMPERATURE=10
NEIGE=5
CUMUL=15
VENT=10
DIRECTION=Nord Est
QUALITE=Poudreuse
VISIBILITE=100
CIEL=Soleil
CIEL_APM=Pluie
ZONE=Altitude
ALTITUDE=3000
RISQUE_REEL=1
LIBRISQUE=Risque faible
TEMPERATURE=+11
NEIGE=0
CUMUL=140
VENT=10
DIRECTION=Nord Est
QUALITE= Normale
VISIBILITE=100
CIEL=Nuageux
CIEL_APM=Nuageux
[BULLETIN]
DATEVAL= 01/08/2001
LIGNE1=TEMPS SEC ET TRES
LIGNE2=LARGEMENT ENSOLEILLE.
LIGNE3=IL FAIT TRES CHAUD
LIGNE4=ET MEME ETOUFFANT
LIGNE5=DANS LES VALLEES.
LIGNE6=LE VENT EST FAIBLE
LIGNE7=EN ALTITUDE
LIGNE8=BONNE JOURNEE A TOUS.
[PREVISIONS]
DATEVAL= 01/08/2001
LIGNE1= JEUDI SOLEIL LE MATIN
LIGNE2= PUIS TEMPS NUAGEUX.
LIGNE3= VENDREDI ECLAIRCIES
LIGNE4= JUSQU'EN MI-JOURNEE.
LIGNE5= PUIS NEIGE VERS 3200M.
LIGNE6=SAMEDI-DIMANCHE PLUIE ET
LIGNE7=BAISSE DES TEMPERATURES
LIGNE8=LUNDI-MARDI BEAU TEMPS.
[ETATS]
SECTEUR=GRANDE MOTTE
PISTE=GLACIER,P,N
PISTE=3.500 m,O,B
PISTE=LEISSE,F,R
REMONTEE=GRANDE MOTTE,O,TPH
Page 16 / 28
Version 2.2
7 décembre 2004
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
REMONTEE=FUNICULAIRE,F,FUNI
LIAISON=LIAISON TIGNES VAL D'ISERE,O
SECTEUR=UN AUTRE SECTEUR
PISTE=GLACIER 2,P,R
PISTE=3.500 m 2,O,V
PISTE=LEISSE 2,F,B
REMONTEE=GRANDE MOTTE 2,O,TPH
REMONTEE=FUNICULAIRE 2,F,FUNI
Page 17 / 28
Version 2.2
7 décembre 2004
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
3 Format du fichier XML
3.1 Exemple de fichier
<STATION nom="COURCHEVEL" lang="fr" version = "2.0">
<PERIODE datevaldeb="01/01/2000" datevalfin="31/12/2000" lib="Hiver" />
<DATEINFO>14/12/2001 08:59</DATEINFO>
<METEO>
<PARAMETRES datevaldeb="14/12/2001" datevalfin="14/12/2001"
datemaj="14/12/2001 08:58">
<ZONE nom="STATION" altitude="1850">
<VALRISQUE>2</VALRISQUE>
<LIBRISQUE>LIMITE</LIBRISQUE>
<RSQ_REEL>0</RSQ_REEL>
<TEMPERATURE>+0</TEMPERATURE>
<NEIGE>3</NEIGE>
<CUMUL>25</CUMUL>
<VENT>60</VENT>
<DIRECTION>SE</DIRECTION>
<QUALITE />
<QLT_ID>4</QLT_ID>
<VISIBILITE>75</VISIBILITE>
<CIEL>NUAGEUX</CIEL>
<CIEL_ID>3</CIEL_ID>
<CIEL_ID_APM>1</CIEL_ID_APM>
<DERNIERE_CHUTE>30/11/2004</DERNIERE_CHUTE>
</ZONE>
<ZONE nom="ALTITUDE" altitude="2700 m">
<VALRISQUE>2</VALRISQUE>
<LIBRISQUE>LIMITE</LIBRISQUE>
<RSQ_REEL>0</RSQ_REEL>
<TEMPERATURE>-17</TEMPERATURE>
<NEIGE>3</NEIGE>
<CUMUL>50</CUMUL>
<VENT>70</VENT>
<DIRECTION>SE</DIRECTION>
<QUALITE />
<QLT_ID>4</QLT_ID>
<VISIBILITE>75</VISIBILITE>
<CIEL>NUAGEUX</CIEL>
<CIEL_ID>3</CIEL_ID>
<CIEL_ID_APM>1</CIEL_ID_APM>
<DERNIERE_CHUTE>30/11/2004</DERNIERE_CHUTE>
</ZONE>
</PARAMETRES>
<BULLETINS>
<BULLETIN datevaldeb="14/12/2001" datevalfin="14/12/2001">
<LANGUE val="en">
<LIGNE />
<LIGNE />
<LIGNE />
<LIGNE>THE BULLETIN</LIGNE>
<LIGNE />
<LIGNE />
<LIGNE />
<LIGNE />
</LANGUE>
<LANGUE val="fr">
<LIGNE />
<LIGNE />
<LIGNE />
<LIGNE>GRAND BEAU TEMPS EN</LIGNE>
<LIGNE>MONTAGNE</LIGNE>
<LIGNE />
<LIGNE />
<LIGNE />
</LANGUE>
</BULLETIN>
</BULLETINS>
<PREVISIONS>
<PREVISION datevaldeb="14/12/2001" datevalfin="15/12/2001">
<LANGUE val="fr">
<LIGNE />
<LIGNE />
Page 18 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
<LIGNE />
<LIGNE>hju</LIGNE>
<LIGNE />
<LIGNE />
<LIGNE />
<LIGNE />
</LANGUE>
</PREVISION>
<PREVISION datevaldeb="14/12/2001" datevalfin="16/12/2001" />
</PREVISIONS>
<INDICES>
<SKIABILITE val="1" lib="1 : Pratique du ski sur moins de 10% du domaine
des pistes balisées" />
<AMBIANCE val="1" lib="Partielle : présence de neige partielle" />
<RETOUR_SKI val="1" lib="Partiel : seul 1 ou plusieurs secteurs de la
station sont assurés" />
<ETAT_ROUTE val="1" lib="Accès dégagé, prévoir les équipements
spéciaux" />
<PISTES_VERTES total="1" ouvertes="0" />
<PISTES_BLEUES total="16" ouvertes="13" />
<PISTES_ROUGES total="6" ouvertes="6" />
<PISTES_NOIRES total="2" ouvertes="2" />
<REMONTEES total="18" ouvertes="17" />
<KM_SKI_NORDIQUE ouvert="50" />
</INDICES>
</METEO>
<ETATS>
<SECTEUR nom="LOZE">
<PISTE nom="LAC BLEU ROUGE" etat="F" type="A" niveau="R" msg=""
entretien_txt="Damée" entretien_num="1"/>
<PISTE nom="JANTZEN" etat="F" type="A" niveau="B" msg=""
entretien_txt="" entretien_num="0" />
<REMONTEE nom="TK DU LAC BLEU" etat="F" type="TK" msg="" attente="0" />
<REMONTEE nom="TC DU PRAZ" etat="F" type="TC" msg="" attente="0" />
<PISTE nom="STADE LOZE" etat="F" type="A" niveau="R" msg=""
entretien_txt="" entretien_num="0"/>
<PISTE nom="DOU DU MIDI HAUT" etat="F" type="A" niveau="R" msg=""
entretien_txt="" entretien_num="0"/>
<PISTE nom="LES BRIGUES" etat="F" type="A" niveau="R" msg=""
entretien_txt="" entretien_num="0" />
</SECTEUR>
<SECTEUR nom="BIOLLEY">
<PISTE nom="STADE DE DESCENTE" etat="F" type="A" niveau="R" msg=""
entretien_txt="" entretien_num="0" />
<PISTE nom="PETIT LAC" etat="F" type="A" niveau="B" msg=""
entretien_txt="" entretien_num="0" />
<REMONTEE nom="TK ALTIPORT" etat="F" type="TK" msg="" attente="0"/>
<REMONTEE nom="TK FERME PRALONG" etat="O" type="TK" msg="" attente="0"/>
<REMONTEE nom="TK CREUX" etat="F" type="TK" msg="" attente="0"/>
<PISTE nom="BIOLLEY DUNES" etat="O" type="A" niveau="B" msg=""
entretien_txt="" entretien_num="0" />
<REMONTEE nom="TK DU FRUIT" etat="F" type="TK" msg="" attente="0"/>
</SECTEUR>
</ETATS>
</STATION>
Page 19 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
3.2 Balise STATION
Cette balise est la racine du document XML. Elle comporte les attributs suivants :
Attribut
nom
lang
version
Définition
Nom de station associée aux
données contenues dans le
fichier.
Langue usuelle de la station
Numéro de version du model de
document XML
Valeurs
Texte
fr : français,
en : anglais,
it : italien
Texte
3.3 Balise PERIODE
Cette balise décrit les périodes d'ouverture de la station. Le nombre de balises période n'est pas limité
et peut être nul.
Attribut
Datevaldeb
Datevaldeb
Lib
Définition
Date de début de la période au
format jj/mm/2000. (l'année à
toujours 2000 comme valeur, les
périodes étant reconductibles
d'une année sur l'autre).
Date de fin de la période au
format jj/mm/2000. (l'année à
toujours 2000 comme valeur, les
périodes étant reconductibles
d'une année sur l'autre).
Libellé de la période
Valeurs
Date
Date
Texte
3.4 Balise DATEINFO
Cette balise indique la date et l'heure de la dernière mise à jour des données sur skiplan.com
Page 20 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
3.5 Balise METEO
Cette balise permet de regrouper l'ensemble des informations météorologiques : observation(s),
bulletin, et prévision(s).
3.5.1
Balise PARAMETRES
Cette balise regroupe les observations météo (balises ZONE) faites dans au plus deux zones
géographiques de la station.
Attribut
Datevaldeb
Définition
Date de début de validité des
observations météo au format
jj/mm/aaaaa
Date de fin de validité des
observations météo au format
jj/mm/aaaaa
Date et heure de dernière
modification des observations
météo au format jj/mm/aaaaa
hh:mm
Datevalfin
Datemaj
3.5.2
Valeurs
Date
Date
Date et heure
Balise ZONE
Cette balise regroupe les différentes observations relevées dans une zone d'observation de la station
Attribut
Nom
Altitude
3.5.2.1
Définition
Nom de la zone d'observation
Altitude en mètre de la zone
d'observation
Valeurs
Texte
Texte
Balise VALRISQUE
Cette balise contient l'identifiant du risque d'avalanche de la zone d'observation associée.
Les valeurs possibles sont :
Valeur
Signification
1
FAIBLE
2
LIMITE
3
MARQUE
4
FORT
5
TRES FORT
3.5.2.2
Balise LIBRISQUE
Cette balise contient le libellé du risque d'avalanche : cf. colonne signification du tableau du § 3.5.2.1
3.5.2.3
Balise RSQ_REEL
Cette balise indique s'il existe un réel risque d'avalanche (valeur 1) ou non (valeur 0). Cette balise
n'est présente que pour les stations équipées du système InfoNeige.
3.5.2.4
Balise TEMERATURE
Cette balise indique la température en °C de la zone d'observation associée.
3.5.2.5
Balise NEIGE
Cette balise donne la hauteur de neige fraîche en cm de la zone d'observation associée.
Page 21 / 28
Montagne
Documentation
3.5.2.6
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
Balise CUMUL
Cette balise donne la hauteur de neige totale (valeur de la balise NEIGE + précipitation des jours
précédents) en cm de la zone d'observation associée.
3.5.2.7
Balise VENT
Cette balise donne la vitesse du vent en km/h
3.5.2.8
Balise DIRECTION
Cette balise donne la direction du vent. Les valeurs possibles sont :
Valeur
N
S
E
O
NE
NO
SE
SO
3.5.2.9
Signification
NORD
SUD
EST
OUEST
NORD EST
NORD OUEST
SUD EST
SUD OUEST
Balise QUALITE
Cette balise donne le libellé de la qualité de neige. Pour les stations non équipées du système
InfoNeige, la valeur de ce champ est libre.
Pour les stations disposant du système InfoNeige les valeurs sont données au § 3.5.2.10.
3.5.2.10
Balise QLT_ID
Cette balise donne l'identifiant de la qualité de la neige. Cette balise n'est présente que pour les
stations équipées du système InfoNeige. Les valeurs possibles sont :
Pour les versions d’infoneige antérieure à la version 1.3A3 :
Valeur
1
2
3
4
5
6
7
Signification
CROUTEE
VENTEE
SOUFLEE
NORMALE
POUDREUSE
FONDANTE
GLACEE
Pour la version d’infoneige 1.3A3 et supérieure :
Valeur
101
102
103
104
105
Signification
FRAICHE
DOUCE
DURE
HUMIDE
DE PRINTEMPS
Page 22 / 28
Montagne
Documentation
3.5.2.11
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
Balise VISIBILITE
Cette balise donne le pourcentage de visibilité de la zone d'observation. Les valeurs possibles dont 0
(aucune visibilité), 25, 50, 75, 100 (visibilité parfaite).
3.5.2.12
Balise CIEL
Cette balise donne l'état du ciel de la zone d'observation. Les valeurs possibles sont : SOLEIL,
COUVERT, NUAGEUX, PLUIE, NEIGE, TEMPETE.
3.5.2.13
Balise CIEL_ID
Cette balise donne l'identifiant de l'état du ciel de la zone d'observation. Cette balise n'est présente
que pour les stations équipées du système InfoNeige. Les valeurs possibles sont :
Valeur
1
2
3
4
5
6
3.5.2.14
Signification
SOLEIL
COUVERT
NUAGEUX
PLUIE
NEIGE
TEMPETE
Balise CIEL_ID_APM
Cette balise donne l'identifiant de l'état du ciel de l'après-midi de la zone d'observation. Cette balise
n'est présente que pour les stations équipées du système InfoNeige. Les valeurs possibles sont les
mêmes que celles de la balise CIEL_ID (cf. § 3.5.2.13).
3.5.2.15
Balise DERNIERE_CHUTE
Cette balise donne la date de la dernière chute de neige. Format : jj/mm/aaaa
Page 23 / 28
Montagne
Documentation
3.5.3
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
Balise BULLETINS
Cette balise regroupe tous les bulletins météo de la station (balises BULLETIN). Actuellement une
station dispose d'un seul bulletin météo.
3.5.4
Balise BULLETIN
Cette balise contient le bulletin météo de la station. Le bulletin peut être traduit dans plusieurs langues
(seulement pour les stations équipées du système InfoNeige).
Attribut
Datevaldeb
Définition
Valeurs
Date de début de validité du
Date
bulletin au format jj/mm/aaaa
Date de fin de validité du bulletin Date
jj/mm/aaaa
Datevalfin
3.5.4.1
Balise LANGUE
Cette balise indique la langue dans laquelle sont traduites les lignes du bulletin météo. Le nombre de
balises LANGUE peut varier d'un jour à l'autre, en fonction du nombre de traductions effectuées par la
station. Les balises LANGUE ne sont présentent que si la station est équipée du système InfoNeige.
Attribut
Val
3.5.4.2
Définition
Valeur de la langue
Valeurs
fr : français,
en : anglais,
it : italien
Balise LIGNE
Cette balise contient une ligne du bulletin météo. Le nombre de balise LIGNE pour un bulletin peut
varier de 1 à 8. Certaines balises peuvent ne pas contenir de texte. La balise LIGNE est fille de la
balise BULLETIN pour les stations qui ne sont pas équipées du système InfoNeige, sinon, elles sont
filles d'une balise LANGUE.
3.5.5 Balise PREVISIONS
Cette balise regroupe les prévisions météo de la station (balises PREVISION).
3.5.6 Balise PREVISION
Cette balise contient la description d'une prévision météo. Les sous balises et attributs sont les
mêmes que pour la balise BULLETIN (se reporter au § 3.5.4).
Page 24 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
3.5.7 Balise INDICES
Cette balise regroupe des indices de type skifrance de la station.
3.5.7.1
Balise SKIABILITE
Cette balise contient l’indice de skiabilité de la station.
Attribut
val
lib
Définition
Indice de skiabilité
Description de l’indice en français
Valeurs
Voir tableau ci-dessous
Voir tableau ci-dessous
Valeurs possibles de l’indice et signification
Valeur
0
1
2
3
4
5
6
7
8
9
10
3.5.7.2
Description
Station fermée
Pratique du ski sur moins de 10% du domaine des pistes balisées
Pratique du ski sur 10 à 20% du domaine
Pratique du ski sur 20 à 30% du domaine
Pratique du ski sur 30 à 40% du domaine
Pratique du ski sur 40 à 50% du domaine
Pratique du ski sur 50 à 60% du domaine
Pratique du ski sur 60 à 70% du domaine
Pratique du ski sur 70 à 80% du domaine
Pratique du ski sur 80 à 90% du domaine
Pratique du ski sur 90 à 100% du domaine
Balise AMBIANCE
Cette balise contient l’indice d’ambiance blanche de la station.
Attribut
val
lib
Définition
Indice de l’ambiance blanche
Description de l’indice en français
Valeurs
Voir tableau ci-dessous
Voir tableau ci-dessous
Valeurs possibles de l’indice et signification
Valeur
0
1
2
3.5.7.3
Description
Totale : présence de neige totale
Partielle : présence de neige partielle
Non : pas de neige
Balise RETOUR_SKI
Cette balise contient l’indice de retour ski aux pieds.
Attribut
val
lib
Définition
Indice de retour ski aux pieds
Description de l’indice en français
Valeurs
Voir tableau ci-dessous
Voir tableau ci-dessous
Valeurs possible de l’indice et signification
Valeur
0
1
2
Description
Total : l'ensemble des secteurs de la station est assuré
Partiel : seul 1 ou plusieurs secteurs de la station sont assurés
Non : le retour n'est pas assuré ou n'existe pas
Page 25 / 28
Montagne
Documentation
3.5.7.4
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
Balise ETAT_ROUTE
Cette balise décrit l’état des routes.
Attribut
val
lib
Définition
Indice de état de la route
Description de l’indice en français
Valeurs
Voir tableau ci-dessous
Voir tableau ci-dessous
Valeurs possible de l’indice et signification
Valeur
0
1
2
3
4
5
3.5.7.5
Description
Routes dégagées, circulation normale
Accès dégagé, prévoir les équipements spéciaux
Accès dégagés, équipements recommandés dans la station
Equipements spéciaux recommandés. Prudence
Equipements spéciaux obligatoires. Prudence
Routes verglacées, équipements obligatoires. Prudence
Balise PISTES_VERTES
Cette balise indique, pour la période en cours, le nombre total de pistes vertes, ainsi que le nombre de
pistes vertes ouvertes.
Attribut
Total
Ouvertes
3.5.7.6
Définition
Valeurs
Nombre total de pistes pour la période en cours
Numérique
Nombre de pistes ouvertes pour la période en cours Numérique
Balise PISTES_BLEUES
Balise identique à la balise <pistes_vertes> mais pour les pistes bleues.
3.5.7.7
Balise PISTES_ROUGES
Balise identique à la balise <pistes_vertes> mais pour les pistes rouges.
3.5.7.8
Balise PISTES_NOIRES
Balise identique à la balise <pistes_vertes> mais pour les pistes noires.
3.5.7.9
Balise REMONTEES
Balise identique à la balise <pistes_vertes> mais pour tous les types de remontées mécaniques.
3.5.7.10
Balise KM_SKI_NORDIQUE
Cette balise indique le nombre de kilomètres de piste de ski nordique ouverte.
Attribut
Ouvert
Définition
Nombre de KM
Valeurs
Numérique
ATTENTION : Cette information n’est valide que si la taille de toutes les pistes de ski nordique a
correctement été saisi dans Infoneige.
Page 26 / 28
Montagne
Documentation
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
3.6 Balise ETATS
Cette balise regroupe l'ensemble des états d'ouverture des pistes, remontées mécaniques et liaisons
de la station. Cette balise a pour fille des balises nommées SECTEUR. Le nombre de balises
SECTEUR varie en fonction de la station.
3.6.1
Balise SECTEUR
Cette balise regroupe les états d'ouverture des pistes, remontées mécaniques et liaisons appartenant
à un même secteur.
Attribut
nom
3.6.2
Définition
Nom du secteur
Valeurs
Texte
Balise PISTE
Cette balise donne l'état d'ouverture d'une piste. Les balises PISTE ne se suivent pas forcément. Elles
peuvent être précédées ou suivies par une balise REMONTEE ou LIAISON. Cette remarque est
également valable pour les balises REMONTEE et LIAISON.
Attribut
nom
etat
Définition
Nom de la piste
Etat d'ouverture de la piste
type
Type de la piste
niveau
Niveau de la piste. Cet attribut n'est disponible que
pour les stations équipées du système InfoNeige.
Dans le cas contraire, le niveau de la piste se trouve
dans l'attribut type. Dans ce cas, ne pas tenir compte
des valeurs définies pour l'attribut type.
Message associé à l'état d'ouverture. Cet attribut peut
être absent s'il n'y a pas de message associé.
Libellé de l’état d’entretien de la piste
Voir tableau ci-dessous
(pas de libellé pour
l’indentifiant 0)
Identifiant de l’état d’entretien de la piste
Voir tableau ci-dessous
msg
entretien_txt
entretien_num
Les valeurs possibles de l’identifiant de l’état d’entretien sont :
Valeur
0
1
2
3
Signification
Pas d’entretien particulier
Damée
Enneigement artificiel
Damée tracée
Page 27 / 28
Valeurs
Texte
O : Ouvert
F : Fermé
P : Prévision d'ouverture
H : Hors service
A : ski alpin
F : ski de fond
B : champ de bosse
S : Snow Park
L : Luge
V : Vert
B : bleu
R : Rouge
N : Noir
Montagne
Documentation
3.6.3
Skiplan.com
Spécifications des fichiers de
données
Version 2.2
7 décembre 2004
Balise REMONTEE
Cette balise donne l'état d'ouverture d'une remontée mécanique.
Attribut
nom
etat
Définition
Nom de la remontée
Etat d'ouverture de la remontée
type
Type de la remontée
msg
Message associé à l'état d'ouverture. Cet attribut peut
être absent s'il n'y a pas de message associé.
Temps d’attente au pied de la remontée
Numérique
attente
3.6.4
Valeurs
Texte
O :Ouvert
F : Fermé
P : Prévision d'ouverture
H : Hors service
FUNI : Funiculaire
TB : télébenne
TC : Télécabine
TPH : Téléphérique
TS : Télésiège
TSD : Télésiège
débrayable
TK : TéléSki
FNT : Funitel
Balise LIAISON
Cette balise donne l'état d'ouverture d'une liaison.
Attribut
nom
etat
msg
Définition
Nom de la liaison
Etat d'ouverture de la liaison
Valeurs
Texte
O :Ouvert
F : Fermé
P : Prévision d'ouverture
H : Hors service
Message associé à l'état d'ouverture. Cet attribut peut Texte
être absent s'il n'y a pas de message associé.
Page 28 / 28