開發指引

資料下載

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


以URL存取資料

1. 基本查詢 (即各資料頁面內 下方之連結)
http://data.ntpc.gov.tw/NTPC/od/data/api/{dataId}?$format={format}
{dataId}:資料代號。各資料頁面內,下方【取得JSON】、【取得xml】、【取得csv】連結可取得
{format}:資料格式。json、xml、csv
範例:新北市政府道路挖掘資訊
http://data.ntpc.gov.tw/NTPC/od/data/api/IMC14/?$format=xml


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

範例一、新北市政府道路挖掘資訊
http://data.ntpc.gov.tw/NTPC/od/data/api/IMC14/?
$format=xml&=10&=100&=ID asc,CaseStart desc
說明:
$format=xml,代表資料格式為xml;
=10,為取得前面10筆資料;
=100,代表跳過前面100筆資料。
所以結果為,
其中ID、 CaseStart 為資料欄位名稱

範例二、新北市政府道路挖掘資訊
http://data.ntpc.gov.tw/NTPC/od/data/api/IMC14/?
$format=xml&=2500&=2000
結果為,


範例三、如資料本身超過2000筆,需取得完整資料,請更改skip參數,取得資料
http://data.ntpc.gov.tw/NTPC/od/data/api/IMC14/?
$format=xml&=2000
取得1~2000筆資料
http://data.ntpc.gov.tw/NTPC/od/data/api/IMC14/?
$format=xml&=2000&=2000
取得2001~4000筆資料
http://data.ntpc.gov.tw/NTPC/od/data/api/IMC14/?
$format=xml&=2000&=4000
取得4001~6000筆資料
以此類推。

範例四、查詢特定內容
http://data.ntpc.gov.tw/NTPC/od/data/api/IMC14/?
$format=xml&=ID eq 32976725
說明:
=ID eq 32976725,
即回傳ID為32976725的內容。
又或者
http://data.ntpc.gov.tw/NTPC/od/data/api/IMC14/?
$format=xml&=CaseType eq 民生
說明:
=CaseType eq 民生,
即回傳CaseType為民生的內容。


檔案格式

JSON、XML、CSV


1. 如資料內容有TWD97的欄位,當定位的正確性不夠時,系統會給予0當作定位失敗。

2. 『新北市公有路外停車場即時賸餘車位數』、『新北市垃圾清運車輛所在位置』為即時資料,系統每三分鐘更新資料,如您有大量及高頻率之資料介接需求時,請讓我們知道,以免因大量介接造成平台效能不彰,影響雙方作業。

3. 『新北市公車到站預估資料』為即時資料,系統每五分鐘更新資料,如您有大量及高頻率之資料介接需求時,請讓我們知道,以免因大量介接造成平台效能不彰,影響雙方作業。


開發指引:檔案下載



以國發會規範API存取詮釋資料

1. 取得分類群組清單
(1)基本查詢
http://data.ntpc.gov.tw/api/v1/rest/group
(2)進階查詢
http://data.ntpc.gov.tw/api/v1/rest/group?limit={limit}&offset={offset}
(3)查詢條件
{limit}:限制最多回傳的資料筆數。預設值: 1000
{offset}:指定從第幾筆後開始回傳, 可與limit配合使用。預設值: 0
(4)查詢範例
http://data.ntpc.gov.tw/api/v1/rest/group
http://data.ntpc.gov.tw/api/v1/rest/group?limit=10&offset=0
(5)檔案格式
JSON


2. 取得群組相關的資料集編號
(1)基本查詢
http://data.ntpc.gov.tw/api/v1/rest/group/{categoryCode}
(2)查詢條件
{categoryCode}:自前述「取得分類群組清單」取得之分類編號。
(3)查詢範例
http://data.ntpc.gov.tw/api/v1/rest/group/I00
(4)檔案格式
JSON


3. 取得標籤清單
(1)基本查詢
http://data.ntpc.gov.tw/api/v1/rest/tag
(2)進階查詢
http://data.ntpc.gov.tw/api/v1/rest/tag?limit={limit}&offset={offset}
(3)查詢條件
{limit}:限制最多回傳的資料筆數。預設值: 1000
{offset}:指定從第幾筆後開始回傳, 可與limit配合使用。預設值: 0
(4)查詢範例
http://data.ntpc.gov.tw/api/v1/rest/tag
http://data.ntpc.gov.tw/api/v1/rest/tag?limit=10&offset=0
(5)檔案格式
JSON


4. 取得標籤相關的資料集編號
(1)基本查詢
http://data.ntpc.gov.tw/api/v1/rest/tag/{tagName}
(2)進階查詢
http://data.ntpc.gov.tw/api/v1/rest/tag/{tagName}?limit={limit}&offset={offset}
(3)查詢條件
{tagName}:自前述「取得標籤清單」取得之標籤名稱。
{limit}:限制最多回傳的資料筆數。預設值: 1000
{offset}:指定從第幾筆後開始回傳, 可與limit配合使用。預設值: 0
(4)查詢範例
http://data.ntpc.gov.tw/api/v1/rest/tag/行政
http://data.ntpc.gov.tw/api/v1/rest/tag/行政?limit=10&offset=0
(5)檔案格式
JSON


5. 取得資料集編號清單
(1)基本查詢
http://data.ntpc.gov.tw/api/v1/rest/dataset
(2)進階查詢
http://data.ntpc.gov.tw/api/v1/rest/dataset?modified={modified}&limit={limit}&offset={offset}
(3)查詢條件
{modified}:日期時間,取得更新時間大於或等於輸入之查詢條件。日期格式為yyyy-MM-dd HH:mm:ss,
如modified=2015-01-01%2023:59:59 (%20為URL中的空白字編碼)。
{limit}:限制最多回傳的資料筆數。預設值: 1000
{offset}:指定從第幾筆後開始回傳, 可與limit配合使用。預設值: 0
(4)查詢範例
http://data.ntpc.gov.tw/api/v1/rest/dataset
http://data.ntpc.gov.tw/api/v1/rest/dataset?modified=2015-01-01%2023:59:59&limit=10&offset=0
(5)檔案格式
JSON


6. 取得資料集詮釋資料
(1)基本查詢
http://data.ntpc.gov.tw/api/v1/rest/dataset/{identifier}
(2)查詢條件
{identifier}:資料集編號。
(3)查詢範例
http://data.ntpc.gov.tw/api/v1/rest/dataset/382000000A-000315
(4)檔案格式
JSON


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

1. 取得資料集之資料資源內容
(1)基本查詢
http://data.ntpc.gov.tw/api/v1/rest/datastore/{resourceID}?filters={filters}&limit={limit}&offset={offset}&fields={fields}&sort={sort}
(2)查詢條件
{resourceID}:資料資源編號。
{filters}:以JSON格式查詢資料內容,將符合條件的資料回傳。
{limit}:限制最多回傳的資料筆數。預設值: 2000
{offset}:指定從第幾筆後開始回傳, 可與limit配合使用。預設值: 0
{fields}:指定查詢的欄位。
{sort}:排序資料。
(3)查詢範例
http://data.ntpc.gov.tw/api/v1/rest/datastore/382000000A-000315-002?filters={"type":"私立"}&limit=5&offset=0&fields=title&sort=recruit
(4)檔案格式
JSON


2. 下載資料集之資料資源全部內容
(1)基本查詢
http://data.ntpc.gov.tw/api/v1/dump/datastore/{resourceID}
(2)查詢條件
{resourceID}:資料資源編號。
(3)查詢範例
http://data.ntpc.gov.tw/api/v1/dump/datastore/382000000A-000315-002