Weather Data

Collecteur Weather Data

Un script PHP de base qui récupère et génère Weather Data au format JSON pour les utiliser sur d'autres sites UCF. Utilise un mécanisme de mise en cache simple qui enregistre les résultats précédemment récupérés et fait référence à ce fichier enregistré si une autre demande est effectuée pendant la durée de cache définie. Les conditions récupérées sont relatives à la zone d'Orlando, mais peuvent être mises à jour pour d'autres projets en modifiant les constantes WEATHER_URL_CURRENT et WEATHER_URL_FORECAST .

Le script est actuellement écrit pour accepter et analyser les données XML de la NOAA. Les codes de condition pour les images sont des chaînes par défaut mais sont convertis selon la norme de code de condition Weather.com/Yahoo (puisque la plupart de nos sites l'utilisent déjà de toute façon.) Ces codes de condition sont également utilisés pour générer une phrase de condition, en raison de la valeur par défaut. Les conditions de la NOAA sont très verbeuses.

Des liens vers divers jeux d'icônes sont fournis dans le flux ; img/weather-small/ contient les icônes utilisées sur ucf.edu ; img/weather-medium/ contient des icônes utilisées dans les e-mails du GMUCF ; img/weather-large/ contient les icônes utilisées sur UCF Today.

Usage

Le flux des conditions actuelles de la région d'Orlando est renvoyé par défaut lorsque index.php est demandé. Utilisez le paramètre GET data pour renvoyer différents ensembles de données :

• ?data=forecastToday : prévisions pour aujourd'hui ; comprend les conditions/températures pour aujourd'hui et ce soir
• ?data=forecastExtended : prévisions sur 5 jours, divisées en jours ("jours", regroupés en "day1-5")

Conditions actuelles et prévisions Valeurs renvoyées

successFetch (chaîne – anciennement « successfulCache » dans la version 1.0.0)

Soit « oui », soit « non » ; si les données demandées ont été récupérées avec succès à partir de la source externe spécifiée, cette valeur est définie sur « oui ». Si un contenu particulier manque dans la source externe pour un jour donné, cette valeur est définie sur « non ».

fournisseur (chaîne)

L'URL du fournisseur Weather Data .

date (chaîne)

La date pour l’ensemble donné de conditions météorologiques. (Format AAAA-MM-JJ)

condition (chaîne)

Une expression relative aux conditions météorologiques. Ces expressions sont vaguement basées sur les descriptions du code de l'API Yahoo Weather : (http://developer.yahoo.com/weather/#codetable)

imgCode (int)

Un code de condition de statut, basé sur le code de statut fourni par la NOAA. Ce code est traduit en un code de condition numérique Weather.com/Yahoo.

imgSmall, imgMedium, imgLarge (chaîne)

Liens vers des icônes météo pertinentes. img/weather-small/ contient les icônes utilisées sur ucf.edu ; img/weather-medium/ contient des icônes utilisées dans les e-mails du GMUCF ; img/weather-large/ contient les icônes utilisées sur UCF Today.

cachedAt (chaîne)

L'horodatage de la dernière mise en cache de cet ensemble de Weather Data .

feedUpdatedAt (chaîne)

L'horodatage de la dernière mise à jour du contenu du flux par le fournisseur de flux (NOAA).

Conditions actuelles, valeurs renvoyées par les prévisions d'aujourd'hui

temp (chaîne)

Lecture de la température actuelle. (Comprend le symbole du degré)

tempN (entier)

Lecture de la température actuelle. (N'inclut pas le symbole du degré)

Valeurs renvoyées par la prévision étendue (par « jour »)

tempMax (chaîne)

Température maximale prévue pour cette journée. (Comprend le symbole du degré)

tempMaxN (entier)

Température maximale prévue pour cette journée. (N'inclut pas le symbole du degré)

tempMin (chaîne)

Température minimale prévue pour cette journée. (Comprend le symbole du degré.) Notez qu'un tempMin « jour 7 » n'est pas fourni par la NOAA.

tempMinN (entier)

Température minimale prévue pour cette journée. (N'inclut pas le symbole du degré.)

Remarques

• Les sites utilisant ce service sont censés mettre en cache les résultats de leur côté. Les données ne doivent être demandées à ce script qu'à un intervalle défini. La nouvelle demande de ce service ne déclenchera pas de récupération de nouveau contenu à moins que la période de cache définie ne soit écoulée.
• Les sites utilisant ce service doivent vérifier les valeurs de données légitimes avant d'afficher les données du flux à l'utilisateur. Même si la valeur « successfulFetch » est définie sur « non », des données partielles peuvent toujours être renvoyées. Les valeurs de secours par défaut ont été supprimées à partir de la version 1.1.3.
• Le cache n'est actualisé avec de nouvelles données que lorsque les anciennes données mises en cache ont expiré ET qu'un ensemble de données nouvellement récupéré a été récupéré avec succès. Ce script continuera à afficher de bonnes données obsolètes jusqu'à ce qu'une autre récupération de données réussie soit effectuée, à condition que ces données obsolètes aient été récupérées dans la même journée.
• Notez que la NOAA n'actualise ses données sur l'état actuel qu'une fois par heure, (environ) 45 minutes après l'heure. Le script de capture météo est configuré pour mettre les données en cache pendant 15 minutes.
• Depuis la version 1.1.9, ce projet utilise cURL pour récupérer les données NOAA. Les environnements exécutant ce projet doivent avoir libcurl installé pour prendre en charge la fonctionnalité cURL de PHP. Consultez la documentation PHP sur cURL pour plus d'informations.