資料服務 / 資料應用工具 / 觀看

應用程式介面工具 Data API


API簡介:TCCIP之應用程式介面 (API) 提供網格化觀測資料與統計降尺度資料2項熱門資料,以Get請求類型提供服務。使用者須前往國家災害防救科技中心災害防救資料服務平台註冊後申請API服務網址與申請者專有之token。

適用資料:提供服務之資料包含0.05度網格化觀測日資料與0.05度AR6統計降尺度日資料與月資料,包含溫度與雨量兩種變數,共計6支API,各API申請網址如下表。

表1 TCCIP提供之6組API申請網址

資料種類

資料集名稱 (申請網址)

網格化觀測資料

網格化觀測雨量日資料

網格化觀測溫度日資料 (日均溫)

AR6統計降尺度資料

AR6統計降尺度月雨量資料

AR6統計降尺度月均溫資料

AR6統計降尺度日雨量資料

AR6統計降尺度日均溫資料

 

申請方式:登入災害防救資料服務平台→進入資料下載網址選擇→點選網路服務[API]→點選動作[加入申請單]→進入會員專區/網路服務申請單→點選[檢視]→填寫資料用途後送出申請,審核通過後可於會員專區/網路服務申請單中檢視申請單,進入申請單後點選[取得API資訊]複製token

 

透過API進行高度客製化的資料下載與應用

資料API可以讓使用者透過網路服務自由的擷取需求資料內容,不受限於資料商店的資料打包方式,可單獨下載特定時間的全臺網格氣候資料。並可在申請成功後利用同一組網址與token取得更新資料,無須每次重新下載更新資料。使用者建立資料處理程式後便可透過API進行自動化的數據處理,並可將相關應用成果整合於其他系統或應用程式。

 

API 指令與參數

災害防救資料服務平台申請API服務審核通過後,會得到資料API的網址 (URI),以及申請者專有之token。之後能夠以Get方式取得API服務下的資料,可加上API參數取得特定之時間與情境的資料,或取得不同格式的資料,各API之參數如表2、表3所示。

 

表2 網格化觀測資料API參數

參數名稱

參數說明

MM

【選填】月份 (2碼月份)

 可使用參數值: 01~12,若未輸入則預設值為01

YYYY

【選填】年份 (4碼西元年)

 可使用參數值: 1960-2022,若未輸入則預設值為1960

DD

【選填】日期 (2碼日期)

 可使用參數值:01~31,若未輸入則預設值為01

DataFormat

【選填】輸出格式

 可使用參數值:json、xml、csv,若未輸入則預設值為json

 

表3 AR6統計降尺度資料API參數

參數名稱

參數說明

MM

【必填】月份 (2碼月份)

 可使用參數值: 01~12

YYYY

【選填】年份 (4碼西元年)

 可使用參數值:historical: 1960~2014

ssp126、ssp245、ssp370、ssp585: 2015~2100

DD

【日資料必填】日期 (2碼日期)

 可使用參數值:01~31

ssp

【必填】暖化情境

 可使用參數值:historical、ssp126、ssp245、ssp370、ssp585

historical: 過去氣候情境,ssp126: 溫室氣體排放情境_低強迫路徑(SSP1-2.6),ssp245: 溫室氣體排放情境_中間路徑(SSP2-4.5),ssp370: 溫室氣體排放情境_中高強迫路徑(SSP3-7.0),ssp585: 溫室氣體排放情境_高強迫路徑(SSP5-8.5)

 有關情境的說明可參考未來推估/情境說明

DataFormat

【選填】輸出格式

 可使用參數值:json、xml、csv,若未輸入則預設值為json

客製化下載與應用:透過API參數設定,可以自由選擇資料下載之時間與情境,提供高度客製化的下載服務;API能串接於其他系統與程式,達成客製化應用。

自動化處理與更新:透過資料處理程式可利用API進行自動化數據處理與分析,使用API可在收到資料更新通知後透過同一組網址與token下載更新資料,無須再次登入資料商店下載所有年份的資料。

使用者取得資料API的URI與token後可自行撰寫程式下載需求資料,例如可透過python程式碼來下載指定年份的網格化觀測資料,範例程式碼可透過以下的加入工具車按鈕下載。

加入工具車 回上頁