跳至主要內容

政府資料開放平臺

捌、資料集詮釋資料欄位詳細說明

一、資料集詮釋資料欄位基本規定說明

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

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

說明此欄位填寫之必要性:

  1. 必須填寫:表示該詮釋資料欄位之內容必須填寫,不可省略。
  2. 系統產生:表示該詮釋資料欄位之內容由系統帶入。
  3. 建議填寫:表示填寫該詮釋資料欄位,將有助於提升資料開放之應用品質,提高資料再利用性。遂若資料開放平臺中已有記錄該欄位資訊,則建議需填寫並提供給資料使用者,反之,若資料開放平臺中無記錄該欄位資訊,則可不填寫;
  4. 選擇性填寫:表示該詮釋資料欄位可依機關自行決定是否填寫。
資料型態 說明該詮釋資料欄位資料填寫內容之資料型態。請見表-6。
填寫規則說明 說明該詮釋資料欄位資料細部填寫規則,包括資料填寫選項或格式。
建議範例 本詮釋資料欄位以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),俗稱網址。
電子郵件 電子郵件地址格式。
列舉 在固定的文字清單中挑選適當的值。

三、資料集詮釋資料欄位定義說明

(一)服務分類

(二)資料提供屬性

(三)資料集識別碼

(四)資料集名稱

(五)資料集描述

(六)資料集上架方式

(七)授權方式

(八)計費方式

(九)資料提供者

(十)提供機關物件識別碼

(十一)提供機關聯絡人姓名

(十二)提供機關聯絡人電話

(十三)提供機關聯絡人電子郵件

(十四)更新頻率

(十五)資料品質

(十六)開始收錄日期

(十七)結束收錄日期

(十八)上架日期

(十九)詮釋資料更新時間

(二十)空間範圍

(二十一)語系

(二十二)相關網址

(二十三)關鍵字

(二十四)備註

(二十五)API 說明文件

(二十六)資料資源描述

這是測試站! This is staging.