跳到主要內容區塊
  • 日期:108-01-08

資料下載
直接於網站中的各資料頁面,依瀏覽器使用方式點選該檔案即可下載

以URL存取資料

1.基本查詢 (即各資料頁面內 下方之連結)

https://data.kinmen.gov.tw/OpenData2.aspx?dataID={dataId}&format={format}
{dataId}:資料代號。各資料頁面內,下方【取得JSON】、【取得xml】連結可取得API介接(貼前台下載圖示)
{format}:資料格式。json、xml

範例:107年12月份人口數統計表
https://data.kinmen.gov.tw/OpenData2.aspx?dataID=170-1&format=json

2.進階查詢

目前平台提供四種查詢條件,格式如下:
top:取得資料筆數(系統最多給予2000筆)。
skip:跳過資料筆數。
orderby:排序資料。
filter:查詢資料內容,將符合條件的資料回傳。
以下為各條件的使用範例:
https://data.kinmen.gov.tw/OpenData2.aspx?dataID={dataId}&format={format}&top={top}&skip={skip}&orderby={orderby}&filter={field}eq{value}
{dataId}:資料代號。
{format}:資料格式。
{top}:取得資料筆數(系統最多給予2000筆)。
{skip}:跳過資料筆。
{orderby}:排序資料。
{field}、{value}:指定查詢的欄位,及其對應的內容。

範例一、107年12月份人口數統計表
https://data.kinmen.gov.tw/OpenData2.aspx?dataID=170-1&format=json&top=10&skip=5&orderby=編號 asc,村別 desc
說明: format=json,代表資料格式為json; top=10,為取得前面10筆資料; skip=5,代表跳過前面5筆資料。 所以結果為,將第6筆(skip=5)至15筆(top=10)資料,以json格式(format=json)回傳 其中編號、 村別 為資料欄位名稱

範例二、107年12月份人口數統計表
https://data.kinmen.gov.tw/OpenData2.aspx?dataID=170-1&format=xml&top=5&skip=10結果為,將第11筆(skip=10)至15筆(top=5,但系統最多給予5筆)資料,以xml格式(format=xml)回傳

範例三、如資料本身超過2000筆,需取得完整資料,請更改skip參數,取得資料
https://data.kinmen.gov.tw/OpenData2.aspx?dataID=170-1&format=json&top=5取得1~5筆資料
https://data.kinmen.gov.tw/OpenData2.aspx?dataID=170-1&format=json&top=5&skip=10取得11~15筆資料
以此類推。

範例四、查詢特定內容
https://data.kinmen.gov.tw/OpenData2.aspx?dataID=170-1&format=json&filter=村別eq東門里
說明:
filter=村別eq東門里,代表將資料欄位名稱『村別』內容為『東門里』的資料抓出,即回傳村別為東門里的內容。

檔案格式
JSON、XML

其他事項
1.如您有大量及高頻率之資料介接需求時,請讓我們知道,以免因大量介接造成平台效能不彰,影響雙方作業。

開發指引:檔案下載

以國發會規範API存取與下載資料

(1)基本查詢
https://data.kinmen.gov.tw/api/v3/page#/
(2)查詢條件
{select}:過濾標題。
{take}:取前幾筆 (資料最多筆數為-50)。
{skip}:跳過前幾筆。
(3)檔案格式
JSON