開發指南

宜蘭縣政府開放資料平臺開發指南
宜蘭縣政府開放資料平臺提供各式資料，民眾或機關可在網站下載或以API介接方式取得資料，俾供後續加值及應用，為方便開發人員取得及使用，本平臺以較普及的檔案格式和業界一般的標準提供資料。每份資料均有詮釋資料，列出資料的格式及欄位定義，協助開發人員充分了解資料內容或應使用的介接技術，針對較複雜的API，並於平臺點擊”資料API”時即提供相關使用說明。 本文件針對實體檔案、URL連結(JSON)及CKAN API的使用方式分別說明。

一、實體檔案下載：

直接於網站中的各資料頁面點擊”下載”即可下載該實體資料，為讓各界容易使用本府開放資料，實體資料提供原則將以結構化的CSV檔案為主，現階段檔案格式包含： CSV 、 XML、JSON 等。 
CKAN平臺中結構化檔案可於各資料頁面點擊”預覽”線上預覽內容。 應用範例：宜蘭縣免費無線熱點(資料格式:CSV)
URL：https://opendataap2.e-land.gov.tw/./resource/files/2016-12-16/ea4103c6124eb24004530e5607e8c084.csv

二、以 API 存取資料：

1.取得資料集資訊：

可直接以系統介接的方式連結該資料集取得內容：

應用範例：宜蘭縣政府宜蘭縣免費無線熱點資料集資訊

URL：

https://opendata.e-land.gov.tw/api/3/action/package_show?id=113006-2016-12-16-1481876937

參數說明：

id：資料集編號
範例查詢結果：

2.取得檔案資源資訊

可直接以系統介接的方式連結該檔案資源取得內容：

應用範例：宜蘭縣政府宜蘭縣免費無線熱點資料集資訊 (CSV)

URL：https://opendata.e-land.gov.tw/api/3/action/resource_show?id=eeb94bb6-456d-408d-b06f-6803de4ae2dd

參數說明：

id：檔案資源編號
範例查詢結果：

3.取得資料集清單

可直接以系統介接的方式取得平臺上資料集清單(資料集編號)：

應用範例：取出資料集清單 6~15 的資料集編號

URL：https://opendata.e-land.gov.tw/api/3/action/package_list?limit=10&offset=5

參數說明：

offset：略過資料筆數，5 表示略過前 5 筆
limit：取得的資料筆數，10 表示取得 10 筆資料
範例查詢結果：