Weather Data

Weather Data採集器

一個基本的 PHP 腳本，用於獲取並輸出 JSON 格式的Weather Data ，以便在其他 UCF 站點上使用。使用簡單的快取機制，保存先前抓取的結果，並在設定的快取持續時間內發出另一個請求時引用該儲存的檔案。檢索到的條件是相對於奧蘭多地區的，但可以透過修改WEATHER_URL_CURRENT和WEATHER_URL_FORECAST常數來更新其他項目。

目前編寫的腳本是為了接受和解析 NOAA XML 資料。圖像的條件代碼預設為字串，但會轉換為 Weather.com/Yahoo 條件代碼標準（因為我們的大多數網站已經在使用它了）。條件短語非常冗長。

提要中提供了各種圖示集的連結； 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 中為“successfulCache”）

要嘛「是」要嘛「否」；如果已從指定的外部來源成功取得請求的數據，則該值設定為「yes」。如果任何一天外部來源中缺少某些特定內容，則該值設為「否」。

提供者（字串）

Weather Data提供者的 URL。

日期（字串）

給定天氣條件組的日期。 （格式年-月-日）

條件（字串）

天氣狀況短語。這些短語大致上是基於 Yahoo Weather API 程式碼描述：(http://developer.yahoo.com/weather/#codetable)

圖像代碼 (int)

狀態條件代碼，基於 NOAA 提供的狀態代碼。該代碼被轉換為 Weather.com/Yahoo 數字條件代碼。

imgSmall、imgMedium、imgLarge（字串）

相關天氣圖示的連結。 img/weather-small/包含 ucf.edu 上使用的圖示； img/weather-medium/包含 GMUCF 電子郵件中使用的圖示； img/weather-large/包含 UCF Today 上使用的圖示。

快取（字串）

最後一次快取這組Weather Data的時間戳記。

feedUpdatedAt（字串）

Feed 提供者 (NOAA) 上次更新其 Feed 內容的時間戳記。

目前狀況、今日預測回傳值

溫度（字串）

當前溫度讀數。 （包括學位符號）

溫度（整數）

當前溫度讀數。 （不包括學位符號）

擴展預測返回值（每“天”）

最大溫度（字串）

當天的最高預測溫度。 （包括學位符號）

tempMaxN（整數）

當天的最高預測溫度。 （不包括學位符號）

溫度最小值（字串）

當天的最低預測溫度。 （包括度數符號。）請注意，NOAA 不提供「day7」tempMin。

tempMinN (int)

當天的最低預測溫度。 （不包括學位符號。）

筆記

• 使用此服務的網站預計會在其端快取結果。只能以設定的時間間隔從此腳本請求資料。重新請求此服務不會觸發新內容的獲取，除非已過了定義的快取期限。
• 使用此服務的網站應在向使用者顯示提要資料之前檢查合法的資料值。即使“successfulFetch”值設定為“no”，仍可能傳回部分資料。自 v1.1.3 起，預設後備值已被刪除。
• 只有當舊的快取資料已過期且新抓取的資料集已成功抓取時，才會使用新資料刷新快取。只要在同一天內檢索到過時數據，此腳本將繼續顯示良好的過時數據，直到執行另一次成功的數據獲取為止。
• 請注意，NOAA 每小時僅在（大約）整點後 45 分鐘刷新一次當前狀況資料。天氣採集腳本設定為快取資料 15 分鐘。
• 從 v1.1.9 開始，該專案使用 cURL 來取得 NOAA 資料。執行此專案的環境必須安裝 libcurl 以支援 PHP 的 cURL 功能。有關詳細信息，請參閱有關 cURL 的 PHP 文件。