開發指南

新竹市政府開放資料平臺開發指南

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

一、實體檔案下載:

直接於網站中的各資料頁面點擊”下載”即可下載該實體資料,為讓各界容易使用本府開放資料,實體資料提供原則將以結構化的CSV檔案為主,現階段檔案格式包含: CSV 、 XML、JSON、XLX(XLSX) 等。 CKAN平臺中結構化檔案可於各資料頁面點擊”預覽”線上預覽內容。 應用範例:市政新聞(資料格式:CSV)

URL:http://opendata.hccg.gov.tw/dataset/administration-20150120-154322-3925/resource/14b4a4b5-d195-40c8-9447-1439b370355d

(http://opendata.hccg.gov.tw/dataset/administration-20150120-154322-3925/resource/14b4a4b5-d195-40c8-9447-1439b370355d) Alt text

二、以 API 存取資料:

1.取得資料集資訊:

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

應用範例:新竹市政府市政新聞資料集資訊

URL:http://opendata.hccg.gov.tw/api/3/action/package_show?id=administration-20150120-154322-3925

(http://opendata.hccg.gov.tw/api/3/action/package_show?id=administration-20150120-154322-3925)

參數說明:

id:資料集編號 

範例查詢結果:

Alt text

2.取得檔案資源資訊

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

應用範例:新竹市政府市政新聞資料集資訊 (XLS)

URL:http://opendata.hccg.gov.tw/api/3/action/resource_show?id=363331ea-26f5-4636-8d4c-14f2ebb6417a

參數說明:

 id:檔案資源編號

範例查詢結果: Alt text

3.取得資料集清單

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

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

URL:[http://opendata.hccg.gov.tw/api/3/action/package_list?limit=10&offset=5](http://opendata.hccg.gov.tw/api/3/action/package_list?limit=10&offset=5)

參數說明:

offset:略過資料筆數,5 表示略過前 5 筆

limit:取得的資料筆數,10 表示取得 10 筆資料

範例查詢結果:

 

Alt text