UI (User Interface)介面為媒介,讓使用者透過圖形畫面來跟系統進行互 動,以獲得所需的資訊。
所取得的 KEY 再呼叫第二組 API,則會回傳淹水損失範圍圖(PNG)以 及相關報表數據(TXT),其中 TXT 屬於純文字格式,可由介接應用系 統解析之後,呈現在自有系統上。
圖 6-1 淹水災害損失評估系統API應用機制
(一)ASC 格式
目前規劃 API 的模式下,僅接受的淹水潛勢資料為 ASC 格 式的檔案,這是一種以二維陣列的方式來描述空間中不同位置的 資料格式,檔案中的每一個數值代表現實世界中一個方形區域的 屬性,內容可以是各種統計值或觀測值(在淹水潛勢資料中為網格 的淹水深度),藉由檔案標頭的起始位置及網格大小可以明確地將 網格在空間中進行定位。在實際使用時必須注意參數內容必須完 整(圖 6-2),以免資料讀取失敗,同時屬性資料內容儘可能有固定 的長度與精度,可加快資料的處理速度,減少錯誤發生。
圖 6-2 淹水潛勢資料檔(ASC)範例
(二)回傳機制與限制
二、介接成果
表 6-2 淹水損失評估系統API 服務申請單
申請日期: 年 月 日
申請機關 主辦人 職 稱
連絡電話 分 機 聯絡手機
電子郵件
申請使用計畫名稱 計畫委託廠商
資料運用範圍
(行政區域)
介接系統網址 申請機關 IP 位置 委託廠商 IP 位置
申請用途概述
(請詳述以 100 字至 200 字為限)
申請起迄日期 年 月 日 ~ 年 月 日 主辦人
核章
主辦課長 核章
機關首長 核章
說明:
一、 申請使用日期一次以一年的使用期限為準。二、每次個 API 到時實可申請展延一次。
圖 6-3 API介接服務申請流程
圖 6-4 API介接服務計算流程
各單位函文用印後之 申請單提出申請
Email 發放 API 介接金鑰
主辦單 位審核 主辦單位受理
補件 駁回
主辦單位函文申請表 至各單位
圖 6-5 逢甲大學淹水圖檔輸入範例
圖 6-6 逢甲大學系統介接回傳成果
表 6-3 各河川局介接情形
推動流通服務服務,建議未來可檢討是否需針對部分易淹水區建置暴
表 6-5 教育訓練課程內容草案 議題一:淹水災害損失推估計畫實施成果與應用
淹水災害損失推估系統架構與功能介紹
本系統損失推估範疇:住宅、工商、農業、畜牧業、
漁業、公共設施損失
系統介接實例成果
淹水損失推估系統成果應用案例
未來展望
議題二:淹水災害推估 API 服務介接與實機操作
淹水災害推估 API 服務介紹
淹水災害推估 API 申請方式
淹水災害推估 API 介接實機操作
淹水災害推估 API 介接可能遇到的問題
淹水災害推估 API 成果使用限制與注意事項
圖 6-7 教育訓練辦理情形1
圖 6-8 教育訓練辦理情形2
圖 6-9 教育訓練辦理情形3