guide de récupération des données - Prevision

Transcription

guide de récupération des données - Prevision
www.prevision-meteo.ch
Données météo pour sites web
Récupération des prévisions météorologiques pour sites web
Prévision-meteo.ch fournit gratuitement les données de prévisions issues de son site pour toutes les localités de
Suisse, France et Belgique. Ces données peuvent être utilisées librement si les conditions suivantes sont respectées.
Conditions d’utilisation
- Utilisation autorisée sur tout site web ne proposant pas de contenu pour adultes, de contenu illicite ou
contraire à la morale.
- Un lien menant vers le site www.prevision-meteo.ch ou l’un de ses contenus est demandé sur le site
utilisant les données.
Méthodes de récupération des données
1. HTML – iframe
Méthode de récupération la plus facile.
Récupération des données
Les vignettes peuvent être récupérées dans deux formats différents. Un format horizontal ou un format
carré. Ceci doit être fait sur la page de récupération des données.
Affichage des prévisions
L’affichage des prévisions sur votre site se fait par un simple copier/coller à l’emplacement désiré du code
récupéré précédemment.
Personnalisation de l’affichage
Les couleurs des vignettes peuvent être personnalisées afin de correspondre au mieux au design de votre
site web.
Vous pouvez changer comme bon vous semble les paramètres suivants :
 Couleur du fond
 Couleur des textes principaux
 Couleur des températures minimales
 Couleur des températures maximales
Les couleurs des vignettes peuvent être personnalisées afin de correspondre au mieux au design de votre
site web.
Pour personnaliser l’affichage il suffit d’ajouter à la suite de l’url récupérée les paramètres comme sur
l’exemple suivant :
http://www.previsionmeteo.ch/services/html/paris/horizontal?bg=ff0000&txtcol=F2F2F2&tmpmin=fff000&tmpmax=378ADF
Les couleurs doivent être indiquées au format hexadécimal.
Liste des paramètres
Description
Couleur d’arrière plan
Couleur des textes principaux
Couleur des températures minimales
Couleur des températures maximales
Paramètre
bg=hexadecimal
txtcol=hexadecimal
tmpmin=hexadecimal
tmpmax=hexadecimal
www.prevision-meteo.ch
Données météo pour sites web
Exemples
Encart météo pour la ville de paris, horizontal avec les couleurs modifiées
<div style="width:510px;color:#000;border:1px solid #F2F2F2;">
<iframe height="85" frameborder="0" width="510" scrolling="no" src="http://www.previsionmeteo.ch/services/html/paris/horizontal ?bg=ff0000&txtcol=F2F2F2&tmpmin=fff000&tmpmax=378ADF "
allowtransparency="true"></iframe>
<a style="text-decoration:none;font-size:0.75em;" title="Détail des prévisions pour Paris"
href="http://www.prevision-meteo.ch/meteo/localite/paris">Prévisions complètes pour Paris</a>
</div>
2. JSON
Les données fournies par www.prevision-meteo.ch peuvent être récupérées au format JSON.
Configuration minimale
Les conditions requises sont de posséder un serveur muni de PHP 5.2.1 et supérieur afin de supporter les
fonctions json_decode() et file_get_contents().
Récupération des données
La récupération des données se fait simplement de la manière suivante. Cette manière de procéder vous
retournera des objets.
Pour retourner les données sous forme de tableau associatif veuillez ajouter TRUE comme deuxième
condition de json_decode($json, true) ;
$json = file_get_contents('CHEMIN_VERS_FICHIER_JSON');
$json = json_decode($json);
CHEMIN_VERS_FICHIER_JSON correspond à :
http://www.prevision-meteo.ch/services/json/[nom_ville][lat=xx.xxxlng=yy.yyy]


Nom_ville - correspond au nom de la localité pour laquelle récupérer les prévisions. Le nom
de la localité peut être récupéré sur la page www.prevision-meteo.ch/services
Par exemple : www.prevision-meteo.ch/services/paris
Lat=xx.xxxlng=yy.yyy – correspond à la latitude et à la longitude du point pour lequel
récupérer les prévisions.
Par exemple : www.prevision-meteo.ch/services/lat=45.32lng=8.54
Affichage des données
Si vous avez converti le fichier JSON sous forme d’objets les données doivent être affichées de cette
manière.
echo $json->city_info->name;
Si le fichier JSON est retourné sous forme de tableau associatif
echo $json['city_info']['name'];
www.prevision-meteo.ch
Liste des paramètres retournés par le flux JSON
Description
Infos localité
Nom de la localité
Latitude
Longitude
Altitude
Heure de lever du soleil
Heure de coucher du soleil
Infos du point réel de la prévision
Latitude
Longitude
Altitude
Conditions actuelles
Date
Heure
Température
Vitesse du vent
Vitesse du vent en rafale
Direction du vent
Pression
Humidité
Conditions (texte) *
Icône
Icône (grande)
Prévisions J0
Date
Jour (format court)
Température minimale
Température maximale
Conditions (texte) *
Icône
Icône (grande)
Données horaires
0H00
Icône
Conditions (texte) *
Température [°C]
Point de rosée [°C]
Refroidissement éolien [°C]
Humidité relative [%]
Pression atmosphérique [Hpa]
Précipitations [mm]
Vitesse du vent à 10m [Km/h]
Rafales à 10m [Km/h]
Direction du vent [°]
Direction du vent
Type de précipitation [0 = pluie,
1 = neige]
Nuages haute altitude
Nuages moyenne altitude
Données météo pour sites web
Paramètre
city_info->name
city_info->latitude
city_info->longitude
city_info->elevation
city_info->sunrise
city_info->sunset
forecast_info->latitude
forecast_info->longitude
forecast_info->elevation
current_condition->date
current_condition->hour
current_condition->tmp
current_condition->wnd_spd
current_condition->wnd_gust
current_condition->wnd_dir
current_condition->pressure
current_condition->humidity
current_condition->condition
current_condition->icon
Current_condition->icon_big
fcst_day_0->date
fcst_day_0->day_short
fcst_day_0->tmin
fcst_day_0->tmax
fcst_day_0->condition
fcst_day_0->icon
fcst_day_0->icon_big
Fcst_day_0->hourly_data->0H00->ICON
Fcst_day_0->hourly_data->0H00->CONDITION
Fcst_day_0->hourly_data->0H00->TMP2m
Fcst_day_0->hourly_data->0H00->DPT2m
Fcst_day_0->hourly_data->0H00->WNDCHILL2m
Fcst_day_0->hourly_data->0H00->RH2m
Fcst_day_0->hourly_data->0H00->PRMSL
Fcst_day_0->hourly_data->0H00->APCPsfc
Fcst_day_0->hourly_data->0H00->WNDSPD10m
Fcst_day_0->hourly_data->0H00->WNDGUST10m
Fcst_day_0->hourly_data->0H00->WNDDIR10m
Fcst_day_0->hourly_data->0H00->WNDDIRCARD10
Fcst_day_0->hourly_data->0H00->ISSNOW
Fcst_day_0->hourly_data->0H00->HCDC
Fcst_day_0->hourly_data->0H00->MCDC
www.prevision-meteo.ch
Nuages basse altitude
Isotherme zéro degré [°C]
K-index (potentiel orageux)
CAPE 180-0
CIN 180-0
Données météo pour sites web
Fcst_day_0->hourly_data->0H00->LCDC
Fcst_day_0->hourly_data->0H00->HGT0C
Fcst_day_0->hourly_data->0H00->KINDEX
Fcst_day_0->hourly_data->0H00->CAPE180_0
Fcst_day_0->hourly_data->0H00->CIN180_0
1H00
…
23H00
Prévisions J1
Prévisions J2
Prévisions J3
fcst_day_1->XXX
fcst_day_2->XXX
fcst_day_3->XXX
* Conditions de temps possibles



















Ensoleillé
Nuit claire
Ciel voilé
Nuit légèrement voilée
Faibles passages nuageux
Nuit bien dégagée
Brouillard
Stratus
Stratus se dissipant
Nuit claire et stratus
Eclaircies
Nuit nuageuse
Faiblement nuageux
Fortement nuageux
Averses de pluie faible
Nuit avec averses
Averses de pluie modérée
Averses de pluie forte
Couvert avec averses

















Pluie faible
Pluie forte
Pluie modérée
Développement nuageux
Nuit avec développement nuageux
Faiblement orageux
Nuit faiblement orageuse
Orage modéré
Fortement orageux
Averses de neige faible
Nuit avec averses de neige faible
Neige faible
Neige modérée
Neige forte
Pluie et neige mêlée faible
Pluie et neige mêlée modérée
Pluie et neige mêlée forte
Exemples
Afficher l’icône du temps actuel
<img src="<?php echo $json->current_condition->icon; ?>" width="45"
height="45" />
Encart avec nom de la localité, jours et icône. Notez que la mise en page doit être effectuée avec du CSS qui
n’est pas inclus dans cet exemple.
<div id="widget_1">
<h1><?php echo $json->city_info->name; ?></h1>
<ul>
<li><span><?php echo $json->fcst_day_0->day_short; ?></span><img src="<?php echo $json->fcst_day_0->icon; ?>"
width="45" height="45" /></li>
<li><span><?php echo $json->fcst_day_1->day_short; ?></span><img src="<?php echo $json->fcst_day_0->icon; ?>"
width="45" height="45" /></li>
<li><span><?php echo $json->fcst_day_2->day_short; ?></span><img src="<?php echo $json->fcst_day_2->icon; ?>"
width="45" height="45" /></li>
</ul>
</div>