使用範例

資料下載

OpenData(以下簡稱本平臺)下載「結構化」資料的方式主要有2種:

1. 手動下載結構化資料檔案

2. 以URL存取資料

請先了解下方說明之傳輸機制,再依需求下載。


結構化資料傳輸機制

為避免大量資料在傳輸過程中斷及頻寬限制,採用「手動下載結構化資料檔案」及「以URL/API存取資料」時,若需要的資料筆數多於1000筆,本平臺每次至多提供「1000」筆資料,使用者可以分批多次下載,以確保資料品質。

可參考『方式一 > (一)透過「應用程式存取網址」> (3)範例』、『方式一 > (二)透過「OPEN API」> (3)範例』。


方式一、以URL/API存取資料,供應用程式介接

(一)透過「應用程式存取網址」

(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)




10042臺北市中正區中華路一段83號 地圖  連絡電話 02-23117722#2393

瀏覽人次 5,151,610        資料更新日期 108年12月16日

請使用1024*768px螢幕解析度獲得最佳網頁瀏覽環境

隱私權政策         資訊安全政策