資料服務 / 資料應用工具 / 觀看
 |
|
API簡介：TCCIP之應用程式介面 (API) 提供網格化觀測資料與統計降尺度資料2項熱門資料，以Get請求類型提供服務。使用者須前往國家災害防救科技中心災害防救資料服務平台註冊後申請API服務網址與申請者專有之token。
適用資料：提供服務之資料包含0.05度網格化觀測日資料與0.05度AR6統計降尺度日資料與月資料，包含溫度與雨量兩種變數，共計6支API，各API申請網址如下表。
表1 TCCIP提供之6組API申請網址
|
資料種類 |
資料集名稱 (申請網址) |
|
網格化觀測資料 |
|
|
網格化觀測溫度日資料 (日均溫) |
|
|
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-2021年，若未輸入則預設值為1960。 |
|
lon |
【選填】經度，從119.3~122.25之間隔0.05的數字，共60個，若未輸入則預設值為119.3。 |
|
lat |
【選填】緯度，從21.8~25.75之間隔0.05的數字，共80個，若未輸入則預設值為21.8。 |
|
DataFormat |
【選填】輸出格式，可選擇json、xml、csv，若未輸入則預設值為json。 |
表3 AR6統計降尺度資料API參數
|
參數名稱 |
參數說明 |
|
lon |
【必填】網格經度值，間隔0.05的數字，共60個 (可使用參數值：119.30~122.25)。 |
|
lat |
【必填】網格緯度值，間隔0.05的數字，共80個 (可使用參數值：21.80~25.75)。 |
|
yyyy |
【必填】資料時間年份 (可使用參數值：歷史基期：1960~2014，未來推估：2015~2100)。 |
|
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程式碼來下載指定網格與指定年份的網格化觀測資料，範例程式碼可透過以下的加入工具車按鈕下載。
| 加入工具車 | 回上頁 |