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>