DATA.epa 行政院環境保護署 環境資源資料開放平台
行政院環境保護署。環境資源資料開放平臺
使用範例
資料下載
OpenData（以下簡稱本平臺）下載「結構化」資料的方式主要有2種：
1. 手動下載結構化資料檔案
2. 以URL存取資料
請先了解下方說明之傳輸機制，再依需求下載。
結構化資料傳輸機制
為避免大量資料在傳輸過程中斷及頻寬限制，採用「手動下載結構化資料檔案」及「以URL/API存取資料」時，若需要的資料筆數多於1000筆，本平臺每次至多提供「1000」筆資料，使用者可以分批多次下載，以確保資料品質。
可參考『方式一 > (一)透過「應用程式存取網址」> (3)範例』、『方式一 > (二)透過「OPEN API」> (3)範例』。
方式一、以URL/API存取資料，供應用程式介接
以上圖示，是進入資料集 "空氣品質監測小時值(一般污染物,每日更新)" 為例：
● 當進入資料集後, 在中間的 "應用程式存取網址"(紅色框), 即會出現字串(是為 "應用存取指令"), 其中包含此資料集的 "代號"({resourceID}) (此例為 "355000000I-000208")
● 另可以利用左邊的 "過濾條件", 縮小搜尋的範圍。在設定過濾條件時, 在紅色框內的 "指令字串" 也會隨之變動。(緊隨接於 {resourceID} 後的字串)
● 使用者即可複製該紅框內的 "指令" 稍做調整, 即可加以應用。
(一)透過「應用程式存取網址」
(1) 格式
https://opendata.epa.gov.tw/webapi/api/rest/datastore/{resourceID}/?format={format}&limit={limit}&offset={offset}&sort={sort}&token={token}
(2) 參數
| {resourceID} | 資料代號，各資料頁面內透過連結可取得，請見下圖。 |
| {format} | 資料格式，可選擇 json、xml、csv。 |
| {limit} | 取最前n筆資料，請填入數字，最大值為1000。 |
| {offset} | 跳過筆數，請填入數字。 |
| {sort} | 排序之欄位名稱。 |
| {token} | 資料下載驗證碼，「會員註冊」頁面進行登記後可取得。 |
(3)範例
3.1 將「空氣品質監測小時值」以SiteId欄位排序，取得第0-1000筆資料：
https://opendata.epa.gov.tw/webapi/api/rest/datastore/355000000I-000208?offset=0&limit=1000&sort=SiteId&format=json&token={token}
3.2 將「空氣品質監測小時值」以SiteId欄位排序，取得第1000-2000筆資料：
https://opendata.epa.gov.tw/webapi/api/rest/datastore/355000000I-000208?offset=1000&limit=1000&sort=SiteId&format=json&token={token}
若需更多資料，請以此類推。
(二)透過「OPEN API」
(1) 格式
https://opendata.epa.gov.tw/api/v1/{DataID}/?skip={skip}&top={top}&format={format}
(2) 參數
| {DataID} | 資料代號，各資料頁面內透過連結可取得，如下圖所示。 |
| {format} | 資料格式，可選擇 json、xml、csv。 |
| {top} | 取n筆資料，請填入數字，最大值為1000。 |
| {skip} | 跳過筆數，請填入數字。 |
| {token} | 資料下載驗證碼，「會員註冊」頁面進行登記後可取得。 |
(3)範例
3.1 將「空氣品質監測小時值」以SiteId欄位排序，取得第0-1000筆資料：
https://opendata.epa.gov.tw/webapi/api/rest/datastore/355000000I-000208?offset=0&limit=1000&sort=SiteId&format=json&token={token}
3.2 將「空氣品質監測小時值」以SiteId欄位排序，取得第1000-2000筆資料：
https://opendata.epa.gov.tw/webapi/api/rest/datastore/355000000I-000208?offset=1000&limit=1000&sort=SiteId&format=json&token={token}
若需更多資料，請以此類推。
方式二、手動下載結構化資料檔案
範例 - 下載淡水測站之空氣品質監測小時值
(一)依使用者需求，預先篩選、過濾資料（步驟1~2）：
於網頁左側之篩選介面，依序選取要過濾的資料項目(資料欄位名稱)、過濾方式及條件後，點擊「顯示查詢結果」，則網頁右側表格會依照條件顯示結果。
(二)檔案下載（步驟3~5）
