附件1_資料集詮釋資料標準指引.pdf

Type: Document | Status: ready
← All sources

資料集詮釋資料標準指引

數位發展部

中華民國113 年5 月

目錄 壹、 目的 ............................................................................................................... 1 貳、 應用範圍 ....................................................................................................... 2 參、 作業原則 ....................................................................................................... 3 肆、 參考資料 ....................................................................................................... 4 伍、 名詞定義 ....................................................................................................... 5 陸、 資料集詮釋資料類別 ................................................................................... 6 柒、 通用性資料集詮釋資料標準框架 ............................................................... 9 捌、 資料集詮釋資料欄位詳細說明 ................................................................. 13 一、 資料集詮釋資料欄位基本規定說明 ..................................................... 13 二、 資料集詮釋資料資料型態說明 ............................................................. 14 三、 資料集詮釋資料欄位定義說明 ............................................................. 15 （一） 服務分類 ........................................................................................ 15 （二） 資料提供屬性 ................................................................................ 16 （三） 資料集識別碼 ................................................................................ 16 （四） 資料集名稱 .................................................................................... 17 （五） 資料集描述 .................................................................................... 17 （六） 資料集上架方式 ............................................................................ 18 （七） 授權方式 ........................................................................................ 19 （八） 計費方式 ........................................................................................ 19 （九） 資料提供者 .................................................................................... 20 （十） 提供機關物件識別碼 .................................................................... 20 （十一） 提供機關聯絡人姓名 ................................................................ 21 （十二） 提供機關聯絡人電話 ................................................................ 21 （十三） 提供機關聯絡人電子郵件 ........................................................ 22 （十四） 更新頻率 .................................................................................... 22 （十五） 資料品質 .................................................................................... 23 （十六） 開始收錄日期 ............................................................................ 24 （十七） 結束收錄日期 ............................................................................ 24 （十八） 上架日期 .................................................................................... 25 （十九） 詮釋資料更新時間 .................................................................... 26 （二十） 空間範圍 .................................................................................... 26

（二十一） 語系 ........................................................................................ 27 （二十二） 相關網址 ................................................................................ 27 （二十三） 關鍵字 .................................................................................... 28 （二十四） 備註 ........................................................................................ 29 （二十五） API 說明文件 ......................................................................... 29 （二十六） 資料資源描述 ........................................................................ 30 （二十七） 資料資源欄位 ........................................................................ 31 （二十八） 檔案格式 ................................................................................ 32 （二十九） 編碼格式 ................................................................................ 33 （三十） 資料資源品質檢測時間 ............................................................ 34 （三十一） 資料下載網址(API 位址) ...................................................... 35 （三十二） 資料量 .................................................................................... 36 （三十三） 資料資源備註 ........................................................................ 36 （三十四） 檢測階層 ................................................................................ 37 （三十五） API 請求方式 ......................................................................... 38 （三十六） API 機器可讀之說明文件 ..................................................... 39 （三十七） API 參數 ................................................................................. 40 （三十八） API 路徑變數 ......................................................................... 41 玖、 資料集英文版詮釋資料欄位定義說明 ..................................................... 42 壹拾、 資料集詮釋資料JSON 範例 ............................................................. 45 一、 檔案資料(含英文版) .............................................................................. 45 二、 API 服務(含英文版) ............................................................................... 50

圖目錄 圖- 1 資料集詮釋資料_檔案資料 ....................................................................... 7 圖- 2 資料集詮釋資料_ API服務 ....................................................................... 8

表目錄

表- 1 本標準框架所參考之詮釋資料標準 ......................................................... 4 表- 2 名詞定義 ..................................................................................................... 5 表- 3 通用性資料集詮釋資料標準框架表_檔案資料 ....................................... 9 表- 4 通用性資料集詮釋資料標準框架表_API 服務 ...................................... 11 表- 5 資料集詮釋資料欄位基本規定說明 ....................................................... 13 表- 6 資料集詮釋資料欄位內容資料型態 ....................................................... 14 表- 7 服務分類 ................................................................................................... 15 表- 8 資料提供屬性 ........................................................................................... 16 表- 9 資料集識別碼 ........................................................................................... 16 表- 10 資料集名稱 .............................................................................................. 17 表- 11 資料集描述 ............................................................................................. 17 表- 12 資料集上架方式 ..................................................................................... 18 表- 13 授權方式 .................................................................................................. 19 表- 14 計費方式 ................................................................................................. 19 表- 15 資料提供者 ............................................................................................. 20 表- 16 提供機關物件識別碼 ............................................................................. 20 表- 17 提供機關聯絡人姓名 ............................................................................. 21 表- 18 提供機關聯絡人電話 ............................................................................. 21 表- 19 提供機關聯絡人電子郵件 ..................................................................... 22 表- 20 更新頻率 ................................................................................................. 22 表- 21 資料品質 ................................................................................................. 23 表- 22 開始收錄日期 ......................................................................................... 24 表- 23 結束收錄日期 ......................................................................................... 25 表- 24 上架日期 ................................................................................................. 25 表- 25 詮釋資料更新時間 .................................................................................. 26 表- 26 空間範圍 ................................................................................................. 26 表- 27 語系 ......................................................................................................... 27 表- 28 相關網址 ................................................................................................. 27 表- 29 關鍵字 ..................................................................................................... 28 表- 30 備註 ......................................................................................................... 29 表- 31 API 說明文件 .......................................................................................... 29 表- 32 資料資源描述 ......................................................................................... 30 表- 33 資料資源欄位 ......................................................................................... 31 表- 34 檔案格式 ................................................................................................. 33

表- 35 編碼格式 ................................................................................................. 33 表- 36 資料資源品質檢測時間 ......................................................................... 34 表- 37 資料下載網址(API 位址) ....................................................................... 35 表- 38 資料資源備註 ......................................................................................... 36 表- 39 檢測階層 ................................................................................................. 37 表- 40 API 請求方式 .......................................................................................... 38 表- 41 API 機器可讀之說明文件 ...................................................................... 39 表- 42 API 參數 .................................................................................................. 40 表- 43 API 路徑變數 .......................................................................................... 41 表- 44 中英詮釋資料欄位對照表 ..................................................................... 42

1

壹、目的 資料集詮釋資料標準指引（以下簡稱本指引）係依據國際相關技 術資料、國內和主要國家目前提供的資料開放架構及格式，產出通用 性資料集詮釋資料標準框架。 因應開放資料即時性及可用性之需求，本指引新增「API服務」 資料提供屬性之資料集詮釋資料標準，資料提供機關可將資料資源以 API方式提供於資料集供各界取用。
期利各業務主管機關以本指引之通用性資料集詮釋資料標準框架 為基礎，以發展符合業務性質之詮釋資料標準內容；並讓各資料提供 者有足夠的詮釋資料描述資料集特性；此外亦方便資料使用者可便 利、有效、快速地找到所需的政府開放資料，以達成跨機關各類資訊 資源交換作業及資料加值應用。

2

貳、應用範圍 資料集詮釋資料標準指引之應用範圍，為個人、學校、團體、企 業或政府機關等使用者，依法得開放或取得各資料開放平臺資料集之 詮釋資料描述資訊。

3

參、作業原則 一、 政府資料開放資料集，宜考量開放後的利用價值，以便利民眾生 活、提升生活品質及擴大運用價值為優先，依其業務屬性考量不 得任意分割，以確保其完整性，並應定期更新資料，自訂檢查機 制及參考各界對資料正確性回饋意見，強化資料品質，以確保其 正確性及時效性。 二、 資料集應採開放格式或依「共通性應用程式介面指引」提供服務 應用程式介面(API 或Web Service)方式以利各界查詢與取用，達 成機器對機器識別讀取及利用。 三、 資料集內容原則採UTF-8 編碼格式，並視應用情形採壓縮檔案對 外提供，以利各界取用，資料集應放置於對外服務之網路空間， 使用HTTPS 協定（HyperText Transfer Protocol Secure）供各界下 載取用，並將資料集之詮釋資料，集中列示於政府資料開放平 臺，俾供各界查詢與連結下載。 四、 各機關已自建平臺者應依「政府資料開放跨平臺介接指引」辦理 與政府資料開放平臺同步作業，機關可視需要另提供資料集詳細 說明網頁以便利各界查詢。

4

肆、參考資料 本節說明資料集詮釋資料標準指引的相關標準，如下表所示。

表- 1 本標準框架所參考之詮釋資料標準 序號 參考項目 1 行政機關電子資料流通實施要點 2 都柏林核心詮釋資料項目(DCMI Metadata Terms) 3 W3C 資料目錄辭彙(Data Catalog Vocabulary, DCAT) 4 國際標準組織211 技術委員會地理資訊詮釋資料標準ISO/TC211 5 詮釋資料標準第三版(Taiwan Spatial Metadata Profile, TWSMP 3.0) 6 國家圖書館詮釋資料格式規範 7 W3C 之XSD 結構標準 8 ISO 639-1 國際標準化組織(ISO)所訂定的語言代碼

本指引之通用性資料集詮釋資料標準框架以行政機關電子資料流 通實施要點為基礎，並參考國際廣泛使用之都柏林核心詮釋資料項目 (DCMI Metadata Terms ) 的基礎15 個核心欄位之描述辭彙定義，以及 全球資訊網協會(World Wide Web Consortium, W3C)推薦之資料目錄辭 彙(Data Catalog Vocabulary, 以下簡稱DCAT) 的資料集詮釋資料架構類 別。 為確保資料集詮釋資料標準框架的通用性，亦參考國內 TWSMP3.0 詮釋資料標準(使用ISO/TC211 標準)、國家圖書館與數位 典藏詮釋資料的特性、定位與規範的設計架構。詮釋資料欄位填寫內 容方面，則參考行政機關電子資料流通詮釋資料及分類檢索規範之分 類辭彙和代碼、W3C XSD 資料型態規範、及國際標準化組織(ISO)所 訂定之語言代碼，確保資料集詮釋資料欄位定義明確。

5

伍、名詞定義 本節列出本指引使用的名詞及其定義，如下表所示。

表- 2 名詞定義 英文名稱 中文名稱 定義 Metadata 詮釋資料 描述資料集的資料 Catalog 目錄 提供資料集的目錄描述 Dataset 資料集 可辨識的資料集合 Distribution 資源供應 資料集所提供之存取資料資源的方式 Data resource 資料資源 提供資料和服務之來源 Metadata class 資料集詮釋資料 類別 描述同一階層的詮釋資料欄位項目集合 Metadata framework 資料集標準框架 為所有詮釋資料欄位項目之集合 Metadata element 詮釋資料欄位項 目 表達對詮釋資料各使用描述單元的定 義、識別、限制條件與規則等 Data type 資料型態 約束資料的解釋與規格，允許有關對應 約束範圍的操作 Metadata schema 詮釋資料綱要 用以描述物件特性及與其他物件關係的 抽象化表示，本指引使用JSON Schema 描述各物件之屬性及元素關係

6

陸、資料集詮釋資料類別 本指引之資料集詮釋資料類別，參考DCAT將詮釋資料分類為三 個主要類別資訊：

(一) 目錄資訊(Catalog) 表示一個目錄資訊，為資料集的索引分類。 (二) 資料集資訊(Dataset) 表示目錄中的一個資料集，為資料集基本描述資訊。 (三) 資源供應資訊(Distribution) 表示資料集所提供之存取資料資源的方式，為下載資料檔案 或存取資料網路服務等描述資訊。

依上述三個主要類別所包含之資料集詮釋資料，以及檔案資料、 API服務兩種資料提供屬性，欄位關聯如圖-1、圖-2所示。其所含的 詮釋資料欄位介紹請見第柒節。

7

圖- 1 資料集詮釋資料_檔案資料

8

圖- 2 資料集詮釋資料_ API服務

9

柒、通用性資料集詮釋資料標準框架 本節列出通用性資料集詮釋資料標準框架，包含檔案資料、API 服務資料集詮釋資料的欄位項目，如下表所示。通用性資料集詮釋資 料標準框架的資料欄位詳細說明請見第捌節。

表- 3 通用性資料集詮釋資料標準框架表_檔案資料 項次 類別 欄位名稱 英文欄位名稱 資料型態 選填條件 1 目錄資訊 Catalog 服務分類 categoryService 列舉 必須填寫 2 資料提供屬 性 categoryDataset 列舉 必須填寫 3 資料集資訊 Dataset 資料集識別 碼 datasetId 整數 系統產生 4 資料集名稱title 文字 必須填寫 5 資料集描述description 文字 必須填寫 6 資料集上架 方式 type 列舉 系統產生 7 授權方式 license 列舉 必須填寫 8 計費方式 cost 列舉 必須填寫 9 資料提供者dataProvider 文字 必須填寫 10 提供機關物 件識別碼 publisherOID 文字 必須填寫 11 提供機關聯 絡人姓名 publisherContactName 文字 必須填寫 12 提供機關聯 絡人電話 publisherContactPhone 文字 必須填寫 13 提供機關聯 絡電子郵件publisherContactEmail 電子郵件 必須填寫 14 更新頻率 updateFrequency 文字 必須填寫 15 資料品質 dataQuality 列舉 系統產生 16 開始收錄日 期 coverageStartedDate 日期 建議填寫

10

項次 類別 欄位名稱 英文欄位名稱 資料型態 選填條件 17 結束收錄日 期 coverageEndedDate 日期 建議填寫 18 上架日期 publishedDate 日期 必須填寫 19 詮釋資料更 新時間 modifiedDate 日期與時間系統產生 20 空間範圍 spatialCoverage 文字 建議填寫 21 語系 language 列舉 必須填寫 22 相關網址 relatedUrl 網址 建議填寫 23 關鍵字 keyword 文字 建議填寫 24 備註 notes 文字 選擇性填 寫 25 資源供應資 訊 Distribution 資料資源描 述 resourceDescription 字串 建議填寫 26 資料資源欄 位 resourceField 字串或陣列必須填寫 27 檔案格式 resourceFormat 列舉 必須填寫 28 編碼格式 resourceCharacterEncoding 列舉 必須填寫 29 資料資源品 質檢測時間resourceQualityCheckTime 日期與時間系統產生 30 資料下載網 址 resourceDownloadUrl 網址 必須填寫 31 資料量 resourceAmount 整數 建議填寫 32 資料資源備 註 resourceNotes 文字 選擇性填 寫 33 檢測階層 qcLevel 文字 選擇性填 寫

11

表- 4 通用性資料集詮釋資料標準框架表_API 服務 項次 類別 欄位名稱 英文欄位名稱 資料型態 選填條件 1 目錄資訊 Catalog 服務分類 categoryService 列舉 必須填寫 2 資料提供屬 性 categoryDataset 列舉 必須填寫 3 資料集資訊 Dataset 資料集識別 碼 datasetId 整數 系統產生 4 資料集名稱title 文字 必須填寫 5 資料集描述description 文字 必須填寫 6 資料集上架 方式 type 列舉 系統產生 7 授權方式 license 列舉 必須填寫 8 計費方式 cost 列舉 必須填寫 9 資料提供者dataProvider 文字 必須填寫 10 提供機關物 件識別碼 publisherOID 文字 必須填寫 11 提供機關聯 絡人姓名 publisherContactName 文字 必須填寫 12 提供機關聯 絡人電話 publisherContactPhone 文字 必須填寫 13 提供機關聯 絡電子郵件publisherContactEmail 電子郵件 必須填寫 14 更新頻率 updateFrequency 文字 必須填寫 15 資料品質 dataQuality 列舉 系統產生 16 開始收錄日 期 coverageStartedDate 日期 建議填寫 17 結束收錄日 期 coverageEndedDate 日期 建議填寫 18 上架日期 publishedDate 日期 必須填寫 19 詮釋資料更 新時間 modifiedDate 日期與時間系統產生 20 空間範圍 spatialCoverage 文字 建議填寫

12

項次 類別 欄位名稱 英文欄位名稱 資料型態 選填條件 21 語系 language 列舉 必須填寫 22 相關網址 relatedUrl 網址 建議填寫 23 關鍵字 keyword 文字 建議填寫 24 備註 notes 文字 選擇性填 寫 25 API 說明文 件 apiDocUrl 網址 必須填寫 26 資源供應資 訊 Distribution 資料資源描 述 resourceDescription 字串 建議填寫 27 資料資源欄 位 resourceField 字串或陣列必須填寫 28 資料資源備 註 resourceNotes 文字 選擇性填 寫 29 API 檢測時 間 resourceQualityCheckTime 日期與時間系統產生 30 API 位址 resourceDownloadUrl 網址 必須填寫 31 API 請求方 式 resourceRequestMethod 網址 必須填寫 32 API 機器可 讀之說明文 件 resourceOasUrl 網址 必須填寫 33 API 參數 resourceRequestParameters

文字 選擇性填 寫 34 API 路徑變 數 resourcePathParameters 文字 選擇性填 寫

13

捌、資料集詮釋資料欄位詳細說明 一、 資料集詮釋資料欄位基本規定說明 本節設計一個共通表格，以列表形式說明檔案資料、API 服 務資料集詮釋資料欄位之規定項目，包括欄位名稱、英文欄位名 稱、定義說明、目的和意義、選填條件、填寫規則說明、建議範 例、不建議範例等，下表說明其基本規定。

表- 5 資料集詮釋資料欄位基本規定說明 規定項目 說明 欄位名稱 列出一個詮釋資料中文欄位名稱。 英文欄位名稱 列出一個建議的詮釋資料英文欄位名稱，以方便機器 可讀之存取應用。 定義說明 簡述欄位定義，協助各類使用者了解其內容，避免錯 誤之解讀。 目的和意義 說明欄位使用目的和意義，協助各類使用者了解此詮 釋資料欄位的重要性與適用性。 資料提供屬性 說明該欄位適用之資料提供屬性，如檔案資料、API 服務，或者兩種皆有。 選填條件 說明此欄位填寫之必要性：

  1. 必須填寫：表示該詮釋資料欄位之內容必須填寫， 不可省略。
  2. 系統產生：表示該詮釋資料欄位之內容由系統帶 入。
  3. 建議填寫：表示填寫該詮釋資料欄位，將有助於提 升資料開放之應用品質，提高資料再利用性。遂若 資料開放平臺中已有記錄該欄位資訊，則建議需填 寫並提供給資料使用者，反之，若資料開放平臺中 無記錄該欄位資訊，則可不填寫；
  4. 選擇性填寫：表示該詮釋資料欄位可依機關自行決 定是否填寫。 資料型態 說明該詮釋資料欄位資料填寫內容之資料型態。請見 表-6。 填寫規則說明 說明該詮釋資料欄位資料細部填寫規則，包括資料填

14

規定項目 說明 寫選項或格式。 建議範例 本詮釋資料欄位以JSON 格式示範詮釋資料之建議範 例。 不建議範例

  1. 本詮釋資料欄位以JSON 格式示範詮釋資料之不建 議範例。
  2. 若有不建議範例，舉出該範例不被建議的原因，避 免不利外界利用；否則必須遵循定義說明與填寫規 則說明，如建議範例所示。

二、 資料集詮釋資料資料型態說明 資料集詮釋資料欄位中的資料型態如下表所說明。

表- 6 資料集詮釋資料欄位內容資料型態 資料型態 說明 字串 字元字串（CharacterString），表示文字的資料型別。 陣列 由相同類型的元素（element）的集合所組成的資料結構。 物件 是類別的具體形象，或者是類別的展現。 整數 整數數值。 日期 日期。YYYY-MM-DD 格式:YYYY 為4 位數西元年；MM 為2 位數月份，01 至12；DD 為2 位數日，01 至31。年月日之區 隔符號為「-」。 時間 日期時間。以日期（date）為基礎再加上時間（時分秒），如 YYYY-MM-DD hh:mm:ss，hh 為小時00 至23；mm 為分鐘00 至59；ss 為秒鐘00 至59。時分秒之區隔符號為「:」。 「年月日」與「時分秒」之間以空白字元分隔。 網址 統一資源定位符(Uniform Resource Locators，URL)，俗稱網 址。 電子郵件 電子郵件地址格式。 列舉 在固定的文字清單中挑選適當的值。

15

三、 資料集詮釋資料欄位定義說明 （一）服務分類

表- 7 服務分類 欄位名稱 服務分類 英文欄位名稱 categoryService 定義說明 服務分類編號3 碼18 類。 （依政府入口網服務分類編號選填） 目的和意義 使用統一分類編號辭彙表有助於使用者搜尋資料 資源。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 必須填寫 資料型態 列舉 填寫規則說明 依據政府入口網服務分類編號選填，共計18 個分 類項目，編碼及類別為： 100 生育保健 200 出生及收養 300 求學及進修 400 服兵役 500 求職及就業 600 開創事業 700 婚姻 800 投資理財 900 休閒旅遊 A00 交通及通訊 B00 就醫 C00 購屋及遷徙 D00 選舉及投票 E00 生活安全及品質 F00 退休 G00 老年安養 H00 生命禮儀 I00 公共資訊 建議範例 {"categoryService":"I00"}

16

不建議範例 無

（二）資料提供屬性 表- 8 資料提供屬性 欄位名稱 資料提供屬性 英文欄位名稱 categoryDataset 定義說明 檔案資料指以開放檔案格式提供資料，API 服務指 以提供開放應用程式介面方式取用資料，皆以無 償方式，不限制使用目的、地區及期間，且不可 撤回之方式授權利用為原則者。 目的和意義 作為識別資料集為檔案資料，或為API 服務。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 必須填寫 資料型態 列舉 填寫規則說明 A 檔案資料 B API 服務 建議範例 {"categoryDataset":"A"} 不建議範例 無

（三）資料集識別碼

表- 9 資料集識別碼 欄位名稱 資料集識別碼 英文欄位名稱 datasetId 定義說明 資料集識別唯一值。 目的和意義 作為識別資料集之唯一值，不能夠重覆與修改。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 系統產生 資料型態 整數 填寫規則說明 系統產出之流水號，有值為修改，空值為新增。 建議範例 {"datasetId":"21246"} 不建議範例 無

17

（四）資料集名稱

表- 10 資料集名稱 欄位名稱 資料集名稱 英文欄位名稱 title 定義說明 資料集的全名。 目的和意義 資料集名稱是資料資源集合的正式名稱，通常以 熟悉且容易辨識名稱為之。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 必須填寫 資料型態 文字 填寫規則說明

  1. 使用正式的名稱為該資料集命名。
  2. 命名不可過於冗長，應盡量簡潔。
  3. 避免過於專業之術語和難以解釋的縮寫。
  4. 相同提供機關不可擁有重複之資料集名稱。
  5. 資料集名稱不可與資料集描述(description)內容 相同 建議範例
  6. {"title":"臺南市國中各校男女生人數統計"}
  7. {"title":"101 年度原住民族生物多樣性傳統知 識調查提案部落"} 不建議範例
  8. {"title":"人數統計"}
  9. {"title":"知識調查提案"}
  10. 不被建議的原因: (1)較容易與其他資料集的資料集名稱重複 (2)較缺乏關鍵資訊，不易識別。

（五）資料集描述 表- 11 資料集描述 欄位名稱 資料集描述 英文欄位名稱 description 定義說明 資料集內容描述。 目的和意義 提供一個清晰且簡明的陳述，讓使用者了解資料 集內容及資料集使用說明。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 必須填寫

18

資料型態 文字 填寫規則說明

  1. 說明資料集的目的及使用說明。
  2. 記錄資料集內容的關鍵環節。
  3. 記錄限制訊息，如資料集的有效性時間或區域 段。
  4. 避免過於專業之術語和難以解釋的縮寫。 5.資料集描述不可與資料集名稱 (title)內容相同。 建議範例 {"description":"環保署發布區域性地下水水質監測 資料，包括一般地下水背景監測值及重金屬污染 物監測值等資料。由於監測資料為每季現場採 樣，並經實驗室檢測分析及資料品保品管程序， 通常需要每季監測結束後隔月始能提供資料。"} 不建議範例
  5. {"description":"地下水水質監測資料"}
  6. 不被建議的原因:描述資訊過少，不易識別。

（六）資料集上架方式

表- 12 資料集上架方式 欄位名稱 資料集上架方式 英文欄位名稱 type 定義說明 說明資料集上架於平臺的方式，為後臺手動上架 或透過介接程式上架兩種方式。 目的和意義 提供使用者有關資料集上架方式。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 系統產生 資料型態 列舉 填寫規則說明 系統判斷資料集創建型態自動產生，包含後臺手 動上架或透過介接程式上架兩種，其編碼及類別 為： rawdata 後臺上架 api 介接程式上架 建議範例 {"type":"rawdata"}

{"type":"api"}

不建議範例 無

19

（七）授權方式

表- 13 授權方式 欄位名稱 授權方式 英文欄位名稱 license 定義說明 資料集授權方式。 目的和意義 資料之開放授權規定，讓使用者合法利用資料。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 必須填寫 資料型態 列舉 填寫規則說明 於政府資料開放平臺中上架的資料集，均需符合 「政府資料開放授權條款第N 版」，其編碼及類別 為N為授權條款版本編號，以數值為之，由1 開始 編號，最大值視為最新版授權。 除授權條款，另加入創作共用相關授權標示。 1 政府資料開放授權條款第1 版 11 創作共用，姓名標示(CC by 4.0) 12 創作共用 姓名標示-相同方式分享(CC by-SA 4.0) 13 開放字型授權條款 OFL-1.1 14 公眾領域貢獻宣告(CC0) 建議範例 {"license":"1"} 不建議範例 無

（八）計費方式

表- 14 計費方式 欄位名稱 計費方式 英文欄位名稱 cost 定義說明 使用資料所應付之費用。 目的和意義 說明資料集計費資訊。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 必須填寫 資料型態 列舉 填寫規則說明 計費方式編碼及類別為： free 免費

20

建議範例 {"cost":"free"} 不建議範例 無

（九）資料提供者

表- 15 資料提供者 欄位名稱 資料提供者 英文欄位名稱 dataProvider 定義說明 為資料集之提供人於電子化政府服務平臺公務帳 號。 目的和意義 紀錄資料集之管理人員，僅能由此管理人員進行 資料集之新增、修改、下架等動作。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 必須填寫 資料型態 文字 填寫規則說明 填寫資料提供者之電子化政府服務平臺公務帳 號。 請參考電子化政府服務平臺公務帳號申請。 建議範例 {"dataProvider":"loginaccount "} 不建議範例 無

（十）提供機關物件識別碼

表- 16 提供機關物件識別碼 欄位名稱 提供機關物件識別碼 英文欄位名稱 publisherOID 定義說明 資料集之提供機關物件識別碼與機關名稱。 目的和意義 提供使用者判斷資料來源的依據、可用度等資訊。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 必須填寫 資料型態 文字 填寫規則說明 請參考物件識別碼中心網站，作為提供機關物件識 別碼（OID），填寫資料集提供機關物件識別碼或加 填機關全銜（以半形垂直線分隔，並避免使用機關

21

簡稱）。 建議範例

  1. {"publisherOID":"2.16.886.101.20003.20069.20001| 國家發展委員會檔案管理局"}
  2. {"publisherOID":"2.16.886.101.20003.20004.20044| 財政部關務署"}
  3. {"publisherOID":"2.16.886.101.20003.20001.20053| 內政部國土測繪中心"}
  4. {"publisherOID":"2.16.886.101.20003.20069”} 不建議範例 無

（十一）提供機關聯絡人姓名

表- 17 提供機關聯絡人姓名 欄位名稱 提供機關聯絡人姓名 英文欄位名稱 publisherContactName 定義說明 資料集提供機關聯絡人姓名或單位與姓名。 目的和意義 作為使用者諮詢相關人員之資訊。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 必須填寫 資料型態 文字 填寫規則說明 填寫資料集提供機關聯絡人姓名或單位與姓名。 範例

  1. {"publisherContactName":"資訊管理處郭大明"}
  2. {"publisherContactName":"資訊室郭先生"}
  3. {"publisherContactName":"大明,小明"} 不建議範例 無

（十二）提供機關聯絡人電話

表- 18 提供機關聯絡人電話 欄位名稱 提供機關聯絡人電話 英文欄位名稱 publisherContactPhone 定義說明 資料集提供機關聯絡人電話號碼。 目的和意義 作為使用者諮詢相關人員之資訊。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 必須填寫

22

資料型態 文字 填寫規則說明 填寫資料集提供機關聯絡人電話。 建議範例 {"publisherContactPhone":"02-23165300#123"} 不建議範例 無

（十三）提供機關聯絡人電子郵件

表- 19 提供機關聯絡人電子郵件 欄位名稱 提供機關聯絡人電子郵件 英文欄位名稱 publisherContactEmail 定義說明 資料集提供機關聯絡人電子郵件。 目的和意義 作為使用者諮詢相關人員之資訊。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 必須填寫 資料型態 電子郵件，電子郵件地址格式可參考政府資料標準平 臺。 填寫規則說明 填寫資料集提供機關聯絡人電子郵件。 建議範例 {"publisherContactEmail":"[email protected],exampl [email protected],[email protected]"} 不建議範例 無

（十四）更新頻率

表- 20 更新頻率 欄位名稱 更新頻率 英文欄位名稱 updateFrequency 定義說明 資料集之更新頻率。 目的和意義 提供使用者有關資料集更新之時序參考。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 必須填寫 資料型態 文字 填寫規則說明

  1. 定義資料集更新週期，一筆資料集僅存在一個 更新頻率。
  2. 於112 年4 月1 日起，該欄位調整填寫方式為

23

一組單值，需填寫是否定期更新(1=是、2= 否)、更新時間(正整數)、更新時間單位(年、 月、日、時、分、秒)。若定期更新，需填寫更 新時間及選擇更新時間單位。 3. 若為不定期更新或不更新之資料集，是否定期 更新請填寫2=否，更新時間及更新時間單位不 需填寫。 建議範例 112 年4 月1 日起調整欄位規範，範例如下： "updateFrequency": { "regularUpdate": "1", "frequency": "1", "unitTime": "月" } 不建議範例

  1. "updateFrequency": { "regularUpdate": "1", "frequency": "每", "unitTime": "月" } 2.不被建議的原因：更新時間須為正整數

（十五）資料品質

表- 21 資料品質 欄位名稱 資料品質 英文欄位名稱 dataQuality 定義說明 依據資料集品質檢測結果，呈現其資料集品質。 目的和意義 提供使用者品質良好之資料集，並逐步提升政府 資料之可用性。 資料提供屬性 檔案資料、API 服務皆有此欄位 選填條件 系統產生 資料型態 列舉 填寫規則說明 依據政府資料開放優質標章暨深化應用獎勵措施 提供資料集標章，系統自動產出，編碼及類別

Page 1 of 3