Weather Data

Weather Data Grabber

Ein einfaches PHP-Skript, das Weather Data in JSON erfasst und ausgibt, um sie auf anderen UCF-Sites zu verwenden. Verwendet einen einfachen Caching-Mechanismus, der zuvor erfasste Ergebnisse speichert und auf diese gespeicherte Datei verweist, wenn innerhalb der festgelegten Cache-Dauer eine weitere Anfrage gestellt wird. Die abgerufenen Bedingungen beziehen sich auf die Region Orlando, können jedoch für andere Projekte aktualisiert werden, indem die Konstanten WEATHER_URL_CURRENT und WEATHER_URL_FORECAST geändert werden.

Das Skript ist derzeit so geschrieben, dass es NOAA-XML-Daten akzeptiert und analysiert. Bedingungscodes für Bilder sind standardmäßig Zeichenfolgen, werden aber in den Bedingungscode-Standard von Weather.com/Yahoo konvertiert (da die meisten unserer Websites ihn ohnehin bereits verwenden). Diese Bedingungscodes werden aufgrund der Standardeinstellung auch zum Generieren eines Bedingungssatzes verwendet NOAA-Bedingungsphrasen sind sehr ausführlich.

Im Feed werden Links zu verschiedenen Symbolsätzen bereitgestellt. img/weather-small/ enthält Symbole, die auf ucf.edu verwendet werden; img/weather-medium/ enthält Symbole, die in den GMUCF-E-Mails verwendet werden; img/weather-large/ enthält Symbole, die auf UCF Today verwendet werden.

Verwendung

Der Feed mit den aktuellen Bedingungen für die Region Orlando wird standardmäßig zurückgegeben, wenn index.php angefordert wird. Verwenden Sie die GET- data , um verschiedene Datensätze zurückzugeben:

• ?data=forecastToday: Prognose für heute; Enthält Bedingungen/Temperaturen für heute und heute Nacht
• ?data=forecastExtended: 5-Tage-Vorhersage, unterteilt in Tage („Tage“, gruppiert in „Tag 1–5“)

Aktuelle Bedingungen und Prognosen, zurückgegebene Werte

successFetch (Zeichenfolge – zuvor „successfulCache“ in v1.0.0)

Entweder „ja“ oder „nein“; Wenn die angeforderten Daten erfolgreich von der angegebenen externen Quelle abgerufen wurden, wird dieser Wert auf „Ja“ gesetzt. Wenn an einem Tag bestimmte Inhalte in der externen Quelle fehlen, wird dieser Wert auf „Nein“ gesetzt.

Anbieter (Zeichenfolge)

Die URL des Weather Data .

Datum (Zeichenfolge)

Das Datum für die gegebenen Wetterbedingungen. (Format JJJJ-MM-TT)

Bedingung (Zeichenfolge)

Ein Satz über die Wetterlage. Diese Ausdrücke basieren lose auf den Codebeschreibungen der Yahoo Weather API: (http://developer.yahoo.com/weather/#codetable)

imgCode (int)

Ein Statuszustandscode, basierend auf dem von der NOAA bereitgestellten Statuscode. Dieser Code wird in einen numerischen Zustandscode von Weather.com/Yahoo übersetzt.

imgSmall, imgMedium, imgLarge (Zeichenfolge)

Links zu relevanten Wettersymbolen. img/weather-small/ enthält Symbole, die auf ucf.edu verwendet werden; img/weather-medium/ enthält Symbole, die in den GMUCF-E-Mails verwendet werden; img/weather-large/ enthält Symbole, die auf UCF Today verwendet werden.

zwischengespeichertAt (Zeichenfolge)

Der Zeitstempel, wann dieser Satz Weather Data zuletzt zwischengespeichert wurde.

feedUpdatedAt (Zeichenfolge)

Der Zeitstempel, als der Feed-Anbieter (NOAA) seinen Feed-Inhalt zuletzt aktualisiert hat.

Aktuelle Bedingungen, von der heutigen Prognose zurückgegebene Werte

temp (Zeichenfolge)

Aktueller Temperaturwert. (Enthält Gradsymbol)

tempN (int)

Aktueller Temperaturwert. (Abschlusssymbol nicht enthalten)

Zurückgegebene Werte der erweiterten Prognose (pro „Tag“)

tempMax (Zeichenfolge)

Maximale vorhergesagte Temperatur für diesen Tag. (Enthält Gradsymbol)

tempMaxN (int)

Maximale vorhergesagte Temperatur für diesen Tag. (Abschlusssymbol nicht enthalten)

tempMin (Zeichenfolge)

Die vorhergesagte Mindesttemperatur für diesen Tag. (Enthält das Gradsymbol.) Beachten Sie, dass die NOAA keinen „day7“ tempMin bereitstellt.

tempMinN (int)

Die vorhergesagte Mindesttemperatur für diesen Tag. (Abschlusssymbol nicht enthalten.)

Notizen

• Von Websites, die diesen Dienst nutzen, wird erwartet, dass sie die Ergebnisse auf ihrer Seite zwischenspeichern. Daten sollten von diesem Skript nur in einem festgelegten Intervall angefordert werden. Durch die erneute Anforderung dieses Dienstes wird kein Abruf neuer Inhalte ausgelöst, es sei denn, der definierte Cache-Zeitraum ist abgelaufen.
• Websites, die diesen Dienst nutzen, sollten auf legitime Datenwerte prüfen, bevor sie dem Benutzer Feed-Daten anzeigen. Auch wenn der Wert „successfulFetch“ auf „no“ gesetzt ist, werden möglicherweise dennoch Teildaten zurückgegeben. Standard-Fallback-Werte wurden ab Version 1.1.3 entfernt.
• Der Cache wird nur dann mit neuen Daten aktualisiert, wenn die alten zwischengespeicherten Daten abgelaufen sind UND ein neu erfasster Datensatz erfolgreich erfasst wurde. Dieses Skript zeigt weiterhin gute veraltete Daten an, bis ein weiterer erfolgreicher Datenabruf durchgeführt wird, sofern diese veralteten Daten am selben Tag abgerufen wurden.
• Beachten Sie, dass die NOAA ihre aktuellen Zustandsdaten nur einmal pro Stunde aktualisiert, und zwar (ungefähr) 45 Minuten nach der vollen Stunde. Das Weather Grabber-Skript ist so eingestellt, dass Daten 15 Minuten lang zwischengespeichert werden.
• Ab Version 1.1.9 verwendet dieses Projekt cURL zum Abrufen von NOAA-Daten. In Umgebungen, in denen dieses Projekt ausgeführt wird, muss libcurl installiert sein, um die cURL-Funktionalität von PHP zu unterstützen. Weitere Informationen finden Sie in der PHP-Dokumentation zu cURL.