使用說明

中央氣象局開放資料平臺提供各式資料,為能優化開放資料的服務,本平臺採用會員服務機制,可使用中央氣象局氣象會員之帳號或透過facebook登入。民眾或機關可在登入本平臺後透過網頁連結下載資料,也可發展程式介接進行檔案下載或資料擷取。

如 無facebook帳號或尚未成為本局氣象會員,請先至本局官網申請註冊(只需有效的郵件帳號,就可免費線上申請),再登入本平臺。成為會員除可享有本局 官網提供之會員服務外,並可取得本平臺所提供之各式開放資料;當有資料集詮釋資料被更新,且資料集提供單位有填寫資料集修訂說明,會員將會收到系統以電子 郵件同步通知該資料集詮釋資料內容已異動

以下分別說明本平臺提供之資料取用方式:

一、透過網站連結下載

於氣象資料開放平臺登入後,於網站中的各資料頁面,直接點選連結下載檔案。

二、發展程式介接

本平臺提供透過URL下載檔案以及 RESTful API 資料擷取方法取用資料,惟因本平臺採用會員服務機制,需帶入資料項目代碼以及有效會員之授權碼,方可取得各式開放資料。其中,資料項目代碼可至資料清單列表查詢,會員之授權碼可於登入會員後點選下方按鈕取得

1.取得授權碼。

※請留意若某一電子郵件已註冊過氣象會員,再以相同郵件帳號透過facebook登入本平臺,將會取得相同之授權碼,若點選上方更新授權碼也會同步影響兩種登入方式可取得之授權碼。

2.檔案下載-使用說明及範例

即日起檔案下載與資料擷取之服務網址提供https網址

https://opendata.cwb.gov.tw/fileapi/v1/opendataapi/{dataid}?Authorization={apikey}&format={format}

※使用說明:可透過URL方式取得資料檔案,須帶入資料項目代碼以及有效之授權碼,格式{format}為選填。

※快取功能說明:透過URL取得資料後,將Response header的{ETAG}代入下一次的Request header的{If-None-Match} 或請參考連結

                
※ URL: https://opendata.cwb.gov.tw/fileapi/v1/opendataapi/{dataid}?Authorization={apikey}&format={format}
{dataid} 為各資料集代碼 (參照:資料清單) ex.F-A0012-001
{apikey} 為會員帳號對應之授權碼 ex.CWB-1234ABCD-78EF-GH90-12XY-IJKL12345678
{format} 為資料格式,請參照各資料集頁面確認可下載之檔案格式 ex.XML、CAP、JSON、ZIP、KMZ、GRIB2
※ 範例:https://opendata.cwb.gov.tw/fileapi/v1/opendataapi/F-A0012-001?Authorization=CWB-1234ABCD-78EF-GH90-12XY-IJKL12345678&format=XML
並請加入快取功能,如上述所示。

3.資料擷取-使用說明及目前開放資料擷取之氣象資料 線上API使用說明

※使用說明:可開發 RESTful API 之 Client 程式擷取資料內容,須以URL帶入資料項目代碼以及各資料項目提供查詢之參數設定,並在 HTTP Header 或URL參數帶入有效之會員授權碼。

詳細介面規格、參數定義與範例說明,可參考以下連結下載說明文件: 中央氣象局氣象資料開放平臺–資料擷取使用說明。

資料共通格式規範說明

為回應各界對氣象開放資料運用更便利之期待,本局持續致力於提供一致性與共通性之開放資料,故擬定氣象開放資料共通格式規範,未來新增之XML類型資料格式將依此規範訂定,部分圖檔資料亦將逐步改版,以全面提供符合規範之氣象開放資料。

規範內容可點選連結下載說明文件參考