資料使用說明

 

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

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

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

 

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

 

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

1. 授權碼取得/更新授權碼

「您的授權碼需登入會員後始可取得」

 

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

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

※ URL:http://opendata.cwb.gov.tw/opendataapi?dataid={dataid}&authorizationkey={apikey}

{dataid}為各資料集代碼 (參照:資料清單) ex. F-A0012-001

{apikey}為會員帳號對應之授權碼 ex. CWB-1234ABCD-78EF-GH90-12XY-IJKL12345678

※ 範例:http://opendata.cwb.gov.tw/opendataapi?dataid=F-A0012-001&authorizationkey=CWB-1234ABCD-78EF-GH90-12XY-IJKL12345678

 

3. 資料擷取-使用說明及目前開放資料擷取之氣象資料 (尚在測試期間)

※ 使用說明:可開發RESTful API之Client程式擷取資料內容,須以URL帶入資料項目代碼以及各資料項目提供查詢之參數設定,並在HTTP Header帶入有效之會員授權碼。詳細介面規格、參數定義與範例說明,可參考以下連結下載說明文件: 中央氣象局氣象資料開放平臺 – 資料擷取使用說明

※ 目前已開放資料擷取之氣象資料:

資料集-資料項名稱 資料項目代碼
一般天氣預報-今明36小時天氣預報 F-C0032-001
鄉鎮天氣預報-單一鄉鎮市區預報資料 F-D0047-001至F-D0047-091(單號)
鄉鎮天氣預報-全臺灣各鄉鎮市區預報資料鄉鎮天氣預報 F-D0047-093
即時海況-潮位-沿岸潮位站監測資料 O-A0017-001
即時海況-海象海溫-浮標站監測資料 O-A0018-001
即時海況-海溫-浮標站與沿岸潮位站監測資料 O-A0019-001
潮汐預報-未來1個月潮汐預報 F-A0021-001

 

資料共通格式規範說明

 

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

規範內容可點選以下連結下載說明文件參考: http://opendata.cwb.gov.tw/opendatadoc/CWB_Data_Dictionary_V1.1.pdf

 

 

資料維護: 中央氣象局