高雄市政府資料開放平台開發指南

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

本文件針對實體檔案、URL連結(JSON)及CKAN API的使用方式分別說明。

一、實體檔案下載：

直接於網站中的各資料頁面點擊”下載”即可下載該實體資料，為讓各界容易使用本府開放資料，實體資料提供原則將以結構化的CSV檔案為主，現階段檔案格式包含： CSV 、 Excel 、XML、KML、SHP、JPG、PDF等。

CKAN平台中結構化檔案可於各資料頁面點擊”預覽”線上預覽內容

應用範例：iTaiwan地點與經緯度(資料格式:CSV)

URL：http://data.kcg.gov.tw/dataset/itaiwan-longitude-and-latitude/resource/cd53c749-abeb-47db-b58c-5954d6c337a1

2.CKAN資料API

範例：Javascript

使用jQuery對資料API發出一個簡單的ajax(JSONP)請求。

var data = {
    resource_id: 'cd53c749-abeb-47db-b58c-5954d6c337a1', // the resource id
    limit: 5, // get 5 results
    q: '高雄' // query for '高雄'
};
$.ajax({
    url: 'http://data.kcg.gov.tw/api/action/datastore_search',
    data: data,
    dataType: 'jsonp',
    success: function(data) {
        alert('Total results found: ' + data.result.total)
    }
});
        

範例：Python

import urllib
url = 'http://data.kcg.gov.tw/api/action/datastore_search?resource_id=cd53c749-abeb-47db-b58c-5954d6c337a1&limit=5&q=高雄'
fileobj = urllib.urlopen(url)
print fileobj.read()