Weather Data

Weather Dataグラバー

他の UCF サイトで使用するために JSON でWeather Data取得して出力する基本的な PHP スクリプト。以前に取得した結果を保存し、設定されたキャッシュ期間内に別のリクエストが行われた場合にその保存されたファイルを参照する単純なキャッシュ メカニズムを使用します。取得される条件はオーランド地域に関連していますが、 WEATHER_URL_CURRENTおよびWEATHER_URL_FORECAST定数を変更することで他のプロジェクト用に更新できます。

スクリプトは現在、NOAA XML データを受け入れて解析するように作成されています。画像の条件コードはデフォルトでは文字列ですが、Weather.com/Yahoo 条件コード標準に変換されます (いずれにせよ、ほとんどのサイトがすでに使用しているため)。これらの条件コードは、デフォルトにより、条件フレーズの生成にも使用されます。 NOAA の条件フレーズが非常に冗長です。

さまざまなアイコン セットへのリンクがフィード内に提供されます。 img/weather-small/には、ucf.edu で使用されるアイコンが含まれています。 img/weather-medium/には、GMUCF メールで使用されるアイコンが含まれています。 img/weather-large/には、UCF Today で使用されるアイコンが含まれています。

使用法

Index.php がリクエストされると、デフォルトでオーランド地域の現在の状況フィードが返されます。 GET パラメーターdata使用して、さまざまなデータ セットを返します。

• ?data=forecastToday: 今日の天気予報。今日と今夜の天気/気温が含まれます
• ?data=forecastExtended: 日に分けられた 5 日間の予報 (「days」、「day1-5」にグループ化)

現在の状況と予測の戻り値

successFetch (文字列 -- 以前の v1.0.0 では 'successedCache')

「はい」または「いいえ」のいずれか。要求されたデータが指定された外部ソースから正常にフェッチされた場合、この値は「yes」に設定されます。いずれかの日の特定のコンテンツが外部ソースから欠落している場合、この値は「no」に設定されます。

プロバイダー (文字列)

Weather Dataプロバイダーの URL。

日付（文字列）

指定された一連の気象条件の日付。 (YYYY-MM-DD形式)

条件（文字列）

気象条件のフレーズ。これらのフレーズは、Yahoo Weather API コードの説明に大まかに基づいています: (http://developer.yahoo.com/weather/#codetable)

imgCode (int)

NOAA によって提供されるステータス コードに基づくステータス条件コード。このコードは、Weather.com/Yahoo の数値条件コードに変換されます。

imgSmall、imgMedium、imgLarge (文字列)

関連する天気アイコンへのリンク。 img/weather-small/には、ucf.edu で使用されるアイコンが含まれています。 img/weather-medium/には、GMUCF メールで使用されるアイコンが含まれています。 img/weather-large/には、UCF Today で使用されるアイコンが含まれています。

キャッシュされたAt (文字列)

このWeather Dataのセットが最後にキャッシュされたときのタイムスタンプ。

feedUpdatedAt (文字列)

フィード プロバイダー (NOAA) がフィード コンテンツを最後に更新したときのタイムスタンプ。

現在の状況、今日の予測の戻り値

温度 (文字列)

現在の温度測定値。 (度記号を含む)

温度 (整数)

現在の温度測定値。 (度記号は含みません)

拡張予測の戻り値 (「日」あたり)

tempMax (文字列)

その日の予想最高気温。 (度記号を含む)

tempMaxN (整数)

その日の予想最高気温。 (度記号は含みません)

tempMin (文字列)

その日の最低予想気温。 (度記号を含みます。)「day7」tempMin は NOAA によって提供されていないことに注意してください。

tempMinN (int)

その日の最低予想気温。 (度記号は含みません。)

注意事項

• このサービスを使用するサイトは、サイト側で結果をキャッシュすることが期待されます。このスクリプトからは、設定された間隔でのみデータをリクエストする必要があります。このサービスを再リクエストしても、定義されたキャッシュ期間が経過しない限り、新しいコンテンツのフェッチはトリガーされません。
• このサービスを使用するサイトは、フィード データをユーザーに表示する前に、正当なデータ値をチェックする必要があります。 「successedFetch」値が「no」に設定されている場合でも、部分的なデータが返される可能性があります。デフォルトのフォールバック値は、v1.1.3 以降削除されました。
• キャッシュは、キャッシュされた古いデータの有効期限が切れ、かつ新しく取得されたデータのセットが正常に取得された場合にのみ、新しいデータで更新されます。このスクリプトは、その古いデータが同じ日以内に取得されたものである限り、別のデータ取得が成功するまで、良好な古いデータを表示し続けます。
• NOAA は、現在の状態データを 1 時間に 1 回 (およそ) 45 分後にのみ更新することに注意してください。 Weather Grabber スクリプトは、データを 15 分間キャッシュするように設定されています。
• v1.1.9 以降、このプロジェクトは cURL を利用して NOAA データを取得します。このプロジェクトを実行する環境には、PHP の cURL 機能をサポートするために libcurl がインストールされている必要があります。詳細については、cURL に関する PHP のドキュメントを参照してください。