DSPL 開發人員指南

DSPL 代表資料集發布語言，表示法格式 中繼資料 (資料集的相關資訊，例如 名稱和提供者，以及內含和顯示的概念) 及 資料集的實際「資料」。這種格式描述的資料集可以是 匯入至 Google 公開資料 Explorer這項工具 資料。

注意：將資料上傳至 Google 公開資料 如要使用公開資料上傳工具，您必須擁有 Google 帳戶。

本文件可協助資料擁有者取得自有內容檔案 可在「公開資料瀏覽器」中使用。我們在教學課程中深入探討 DSPL 結構定義和支援功能的詳細資料。基本知識 通常會假設 XML 是關聯資料庫的知識 很實用

雖然這並非硬性規定，但我們仍建議您詳閱教學課程，其中的內容較短 反而會更容易理解文件內容

總覽

DSPL 資料集是一個 .zip 檔案，內含一個 XML 檔案和一組 CSV 檔案 檔案。CSV 檔案是簡單的資料表，內含資料集的資料 XML 檔案則說明資料集的中繼資料後者包含 資訊中繼資料，例如測量指標的說明 結構中繼資料，例如資料表之間的參照。這項中繼資料 可讓非專業使用者探索及以圖表呈現資料。

程序

一般來說，DSPL 資料集的建立程序如下所示 (部分 可能會同時進行)：

  1. 建立 DSPL XML 檔案。
  2. 識別要在資料集中使用的任何外部資料來源。
  3. 定義概念、切片和主題 (選擇性)。疊代 更新您 DSPL 檔案的內容。
  4. 將來源資料匯出為 .csv 檔案。
  5. 建立 DSPL 資料集。
  6. 將資料集提交給 Google。

XML 結構

總覽

DSPL XML 檔案會定義資料集的中繼資料，包括 概念、切片、主題和表格的結構關係 雖然您可以使用資料處理工具手動建立這個檔案 和指令碼都能大幅簡化流程參閱新版的 DSPL 檔案範例 視窗。

檔案含有幾個區段，並在表格中匯總 。我們接著在表格之後，以下列字串說明每種方法。 詳細資料。

章節 摘要 更多資訊
標頭和匯入 資料集所有其他元素的父項。包含 資料集的目標命名空間 (即 ID)，以及 任何匯入資料集的命名空間 說明文件
資料集資訊 資料集的名稱、說明和網址。 說明文件
供應商資訊 資料集提供者的名稱、說明和網址。 說明文件
概念

「事物」的定義(例如 國家/地區、失業率、性別等)

每個概念都有專屬 ID，可供 扇區和表格

 說明文件
Slice

報表中有統計資料的概念組合 每個區塊都包含維度和 指標。

Slice 參考資料概念和資料表，其中包含實際 資料。每個片段都有專屬識別碼，可以由 內含實際資料的資料表

 說明文件
資料表 定義概念和片段的資料。概念資料表訴訟保留 列舉和配量表會保留統計資料。資料表的定義 ，然後指向包含實際資料的 .csv 檔案。 說明文件
主題 用於整理資料集概念的類別。雖然這不是硬性規定 這對於瀏覽資料的使用者非常實用 說明文件

標頭和匯入

宣告「公開資料」命名空間

DSPL 資料集的開頭為頂層 <dspl> 元素。 可用來包含所有資料集資訊 儲存在整個檔案中使用的命名空間範例如下：

<?xml version="1.0" encoding="UTF-8"?>
<dspl targetNamespace="http://www.example.com/mystats"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://schemas.google.com/dspl/2010" >
    ...
</dspl>

「命名空間」是一組專屬 ID，可與 XML 架構 (一組 XML 元素和屬性)。 targetNamespace 會提供用於識別資料集的 URI。 此 URI 並不需要指向實際資源，但這項建議是 URI 會解析為描述內容的文件

您不需要提供 targetNamespace。如果發生以下情況： 如果不是，則匯入時，系統會自動產生一組 讓應用程式從可以最快做出回應的位置 回應使用者要求

targetNamespace 屬性後面接著一系列的 xmlns 屬性，用於指定要使用的其他 XML 架構 檔案中。每個 DSPL 檔案都必須包含 Google 公開資料架構。 其 URI 為「http://schemas.google.com/dspl/2010」並做為 預設命名空間也應該提供標準的 W3 XML 架構 以「http://www.w3.org/2001/XMLSchema-instance」識別。阿斯 下一節所述，您還可以新增其他命名空間 擷取來自其他資料集的資訊

匯入其他資料集命名空間

資料集可重複使用其他資料集的定義和資料。Google 與 會提供一些基本資料集 會出現在使用者資料中舉例來說，大多數資料集都需要有概念 代表年份。這時您可以使用年份，而非定義新概念。 「http://www.google.com/publicdata/dataset/time」中， 請參閱 Canonical 概念頁面。

如要使用外部資料集，請將 <import> 元素新增至 DSPL 檔案位在命名空間宣告後方，並指出 如下：

<import namespace="http://www.google.com/publicdata/dataset/google/time"/>

然後新增匯入的命名空間 (本例中是 time="http://www.google.com/publicdata/dataset/google/time") 新增至檔案頂端的命名空間宣告，如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<dspl targetNamespace="http://www.stats-bureau.com/mystats"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://schemas.google.com/dspl/2010"
    xmlns:time="http://www.google.com/publicdata/dataset/google/time" >
<import namespace="http://www.google.com/publicdata/dataset/google/time"/>

您的 DSPL 檔案現在可以參照 Google 公開資料中的元素 時間資料集。重複播放 執行此程序。

參照外部資料集的內容

匯入另一個資料集後，你必須能夠從 概念、配量以及資料集內的資料如要這麼做，您可以使用 採用 prefix:other_id 格式的參照，其中 prefix 是 Pod 命名空間 外部資料集

以下是 year 概念的參照範例： time 資料集 (如上所述)：

<slices>
  <slice id="country_slice">
    <dimension concept="country"/>
    <dimension concept="time:year"/>
    <metric concept="population"/>
    <table ref="country_slice_table"/>
  </slice>
  ...
</slices>

資料集資訊

<info> 元素包含描述性資訊 關於資料集相關 XML 元素的示例和詳細資料如下： 。

範例

<info>
  <name>
    <value>Unemployment Rates</value>
  </name>
  <description>
    <value>Worldwide unemployment rates by region</value>
  </description>
  <url>
    <value>http://www.example.com/mystats/info.html</value>
  </url>
</info>

元素

元素 必填與否 說明
<info> 是 包含關於資料集的所有說明資訊。收錄 子項元素 <name>、 <description>和<url>。
<name> 是 <info> 的子項。包含子元素 <value>，用於識別
<description> 選用 <info> 的子項。包含子元素 <value>，其中包含
<url> 是 <info> 的子項。提供更多網址的網址連結 關於資料集的相關資訊

提供者資訊

<provider> 元素會列出 資料集供應商相關 XML 元素的示例和詳細資料如下： 。

範例

<provider>
  <name>
    <value>Bureau of Statistics</value>
  </name>
  <url>
    <value>http://www.example.com</value>
  </url>
</provider>

元素

元素 必填與否 說明
<provider> 是 包含資料集提供者的所有描述性資訊。 包含子元素 <name> 和 <url>。
<name> 選用 <provider> 的子項。包含子元素 <value>，用於識別資料集名稱 。
<url> 選用 <info> 的子項。含有更多資訊的網址連結 資料集供應商的相關資訊

概念

說明

每個資料集都包含一或多個概念。概念是 定義資料集中顯示的資料類型。如果資料集含有 比方說，客層人口資料 國家/地區、州/省、人口和年份對應於 稱為該概念的「執行個體」。概念 通常出現在資料集中，但有一些概念 (例如時間或年份) 可能會描述在外部資料集中

每個概念可以有一或多個「屬性」。資源 屬於長期固定的概念例項的特性。例如： 國家/地區概念可以是 name、 population和capital。

概念也可以有一或多個「屬性」，屬性提供 也就是概念層級的資訊，而非個別例項適用對象 舉例來說，如果資料集的失業率概念 我們可以使用屬性來指明這個概念為百分比。 屬性的另一個常見用途是提供單位 可能不準確或不適當

範例

以下舉例說明使用專屬 ID 的國家/地區概念 country 和 name 屬性。概念 ID 可以是 用來從配量和資料表中參照概念。

<concept id="country" extends="geo:location">
  <info>
    <name><value>Country</value></name>
    <description>
      <value>My list of countries.</value>
    </description>
  </info>
  <type ref="string"/>
  <property id="name">
    <info>
      <name><value>Name</value></name>
      <description>
        <value>The official name of the country</value>
      </description>
    </info>
    <type ref="string" />
  </property>
  <property concept="geo:continent" isParent="true"/>
  <property id="capital" concept="geo:city" />
  <table ref="countries_table" />
</concept>

這個範例的運作原理如下：

  • 這段程式碼描述了概念國家/地區， country 和 name 屬性， continent和capital。
  • 這個概念延伸了 geo:location，這是 地點。擴充 geo:location、country 沿用延伸概念定義的所有屬性和屬性： 屬性名稱、說明、網址、經緯度還可以 以便 country 重新定義其中一部分屬性 屬性，前提是定義與提供的 是由延伸概念構成
  • <info> 元素的概念描述鍵 關於概念的資訊這會顯示在資料集的 「公開資料瀏覽器」的到達網頁。
  • <type> 概念是指 內容。在本例中，這是字串，但可能會有所不同。概念 母體的類型是 integer；概念 Eurovision winner 可以包含類型布林值。
  • <property> 元素用來說明 包括專屬 ID (id)、info 和 type。屬性也可能參照概念， 表明它們的值就是這些概念的有效例項。

  • 這個概念會參照指向 而是包含實際資料的 CSV 檔案資料表參照了資料表 如下所示：<table ref="countries_table"/>。

    如果您的概念參照資料表，相關聯的資料檔案必須列出 模型中的所有執行個體例如，您無法 僅列出資料集中的少數國家/地區。(如果有 是您所關注的國家/地區之一 說明這些概念例如 mycountries)。

元素

元素 必填與否 說明
<concepts> 是 頂層元素。包含所有<concept> 元素。
<concept> 是 用於識別概念。必要屬性的值 id 在資料集內的概念不得重複。如果 這個概念參照了概念資料表 「id」必須與用來說明概念的欄標題相符： 資料表。extends 屬性可用來表示 這個概念延伸到另一個概念如果 extends 必須與 或 prefix:concept_id 格式，其中 concept_id 是匯入模型中定義的概念 ID 與 prefix 相關聯的外部資料集。
<info> 選用 包含概念的描述性資訊。
<name> 是 <info> 的子項。概念的名稱。 子元素 <value> 包含文字 - 用於 例如：Country。
<description> 選用 <info> 的子項。包含子元素 <value>，其中包含 概念
<url> 選用 <info> 的子項。包含子元素 <value>，其中包含 概念
<pluralName> 選用 <info> 的子項。的複數名稱 概念子元素 <value> 包含文字 -例如：Countries。
<totalName> 選用 <info> 的子項。組合的名稱 模型中的所有執行個體子元素 <value> 包含文字，如果是 country 例如 World
<type> 選用 識別這個概念描述的內容類型。必備 ref 屬性允許的值如下：
  • 字串
  • float
  • 整數
  • 日期
  • 布林值
如果概念延伸到另一個概念，則可省略類型。 此時，它沿用自延伸概念。
<property> 選用

概念的屬性，例如 capital。這個鍵 必要屬性 id 的 概念選擇性的 concept 屬性可用於 表示這個屬性的值是給定的 概念如果指定 concept，則 id ；其值是以隱含形式定義為 參考的概念 (例如<property concept="geo:country"/> 相當於 <property id="country" concept="geo:country"/>)。

屬性可包含布林值 isParent 屬性 表示概念執行個體之間的關係 ，這個屬性的值是階層式的。

屬性可包含布林值 isMapping 屬性 表示執行個體的執行個體之間有 1-1 的對應關係 概念和屬性值

屬性可以指定巢狀 info 和 type，其定義與概念相同。 type如果屬性沒有指定 concept 屬性，而且必須與 所參考的概念 (如果有的話)
<attribute> 選用

概念的屬性。屬性代表了 各概念的相關資訊 (例如GDP 是一個百分比)。這個鍵 必要屬性 id 的 概念選擇性的 concept 屬性可用於 表示該屬性的值是 概念如果指定 concept，則 id 可以省略其值是以隱含形式定義為 所學概念(例如：<attribute concept="unit:unit"/> 相當於 <attribute id="unit" concept="unit:unit"/>。

屬性可以指定巢狀 info 和 type，其定義與概念相同。 type如果屬性沒有指定 concept 屬性，而且必須與 所參考的概念 (如果有的話)
<table> 選用 識別內含概念資料的資料表。 必要 ref 屬性的值必須與資料表相符 在相關 <table> 元素中指定的 ID。

Slice

說明

配量是資料存在的概念組合。切片 包含兩種概念參照：維度和 指標。維度是一種用來區隔或篩選的概念 資料。另一方面，指標描述觀察到的值 與各個資料點相關聯的值

一般來說，維度是類別型維度，但指標並非類別 數值。這些範例各自的原型範例 如下：

  • 維度：國家/地區、州、縣、區域、年份、 月、性別、年齡層、產業區隔
  • 指標：人口、國內生產總值、失業率、讀寫能力 收益、費用、價格

範例

<slices>
  <slice id="country_slice">
    <dimension concept="country"/>
    <dimension concept="time:year"/>
    <metric concept="population"/>
    <table ref="country_slice_table"/>
  </slice>
  ...
</slices>

這個範例的運作原理如下：

  • 此圓餅圖代表各國家/地區的人口。
  • 包含「population」指標和維度 country和year。每個維度都是一個概念 已經在其他位置定義了country 概念和指標 population 存在於與目前配量相同的資料集中， 參照的方式如下：concept="country"
  • 匯入的資料集時間內存在 year 概念。 由概念名稱 (year) 之前使用的前置字串所識別。 例如：concept="time:year"
  • 此配量參照了指向 CSV 檔案的資料表 包含實際資料資料表的參照方式如下： <table ref="country_slice_table"/>。(請參閱上方說明) 以瞭解如何匯入 資料集)。

注意：一般來說，您的資料集 盡可能提高指標的靈活度 維度。舉例來說，與其建立指標 Female Unemployment和Male Unemployment， 建立單一指標 Unemployment，然後新增維度 Gender包含執行個體 Female和 Male。

元素

元素 必填與否 說明
<slices> 是 頂層元素。包含所有<slice> 元素。
<slice> 選用 用於識別切片。必要屬性的值 id 在該片段中不得重複。
<dimension> 選用 透過參照概念定義切片的維度。 必要屬性 concept 的值必須完全相符 概念的專屬 ID，如果概念有問題，請使用有效的前置字元 屬於外部匯入資料集。
<metric> 選用 參照概念來定義配量的指標。這個鍵 必要屬性 concept 必須完全符合 概念的專屬 ID，如果概念屬於 外部匯入資料集
<table> 是 識別含有某片段資料的資料表。這個鍵 必要的 ref 屬性必須與資料表 ID 相符 在相關 <table> 元素中指定。
<mapDimension> 選用 <table> 的子項。包含 concept 和 toColumn 屬性；第一個值是 做為標準，第二個值是表格欄 相應的程式碼
<mapMetric> 選用 <table> 的子項。包含 concept 和 toColumn 屬性；第一個值是 一個指標，第二個值是表格欄 相應的程式碼

表格

說明

DSPL 檔案的 tables 部分會識別這項資料 資料表所包含的資料表這些表格可做為概念 依照片段每個 <table> 元素都會指定 資料表及其類型，並指向包含資料表的 CSV 檔案 資料。

範例

<tables>
  <table id="country_slice_table">
    <column id="country" type="string"/>
    <column id="year" type="date" format="yyyy"/>
    <column id="population" type="integer"/>
    <data>
      <file format="csv" encoding="utf-8">country_slice.csv</file>
    </data>
  </table>
  ...
</tables>

這個範例的運作原理如下：

  • 此範例說明資料表 country_slice_table。 資料表內含 country、year 和 population。
  • 資料表中的每個資料欄都有專屬 ID，由 id 屬性。這個 ID 必須與相應的 欄標題。
  • 選用 type 屬性的值會定義資料 每個資料欄的類型
  • <data> 元素說明實際的 .csv 檔案 (country_slice.csv)。檔案格式為 一律為 csv。

元素

元素 必填與否 說明
<tables> 是 頂層元素。包含所有<table> 元素。
<table> 是 用於識別資料表，必要屬性的值 資料表的 id 不得重複。
<column> 選用 <table> 的子項。資料欄的相關資訊 加入表格。包含下列屬性：
  • id (必要)：欄位 ID。
  • type (選用)：資訊的資料類型 在指定資料欄中。允許的值包括：string、 float、integer、date 或 boolean。
<data> 選用 <table> 的子項。參照的資料檔案 表格。如果檔案名稱採用網址格式 (例如：http://...)，系統會透過 適當的通訊協定 (HTTP、HTTPS 或 FTP)；否則，檔案 與資料集一起命名時，必須一併命名為此名稱。 必要屬性 format 的值為 一律為 csv。雖然 encoding 屬性 為選用項目，.csv 檔案必須採用 UTF-8 編碼。

主題

說明

Topics 會以階層方式分類概念，方便使用者瀏覽 方便您分析資料集

<topics> 元素應會顯示在 <concepts> 元素。( 否則您可能無法上傳資料集 元素顯示順序錯誤)。如要使用主題，請前往 概念定義

範例

以下是主題定義範例：

<topics>
  <topic id="population_indicators">
    <info>
      <name>
        <value>Population indicators</value>
      </name>
    </info>
  </topic>
  ...
</topics>

...以下是這個主題的參考範例：

<concept id="population">
  <info>
    <name>
      <value>Population</value>
    </name>
    <description>
      <value>Size of the resident population.</value>
    </description>
  <topic ref="population_indicators"/>
  <type ref="integer"/>
</concept>

主題可以是巢狀結構，一個概念可以參照多個主題。

元素定義

元素 必填與否 說明
<topics> 是 頂層元素。包含所有<topic> 元素。
<topic> 是 用於識別主題。必要屬性的值 在資料集內，id 不得重複。
<info> 選用 <topic> 的子項。包含 主題。
<name> 選用 <info> 的子項。其子元素 <value> 會指定主題的名稱。

DSPL 資料檔案

除了 XML 中繼資料檔案外，DSPL 資料集也可以 包含一或多個 CSV 格式的資料檔案。每個資料檔案 支援資料集中的資料表，而且會參照其對應的資料表 「<data>...</data>」專區。從概念上來說 關聯資料表則用於代表 定義或切片資料。這些資料檔案類型 。

請注意，不論用途為何，所有資料檔案都必須 以半形逗號分隔 (CSV) UTF-8 文字檔。檔案只能包含純文字 文字；沒有 HTML。您可以手動建立資料檔案，但實際上 必須在包含原始資料的工具中 來源 (例如試算表) 或匯出檔案中。

檔案可以與資料集一起封裝，或者名稱格式是 透過 HTTP、HTTPS 或 FTP 從遠端來源擷取的網址。

概念資料檔案

概念資料檔案內含每個概念的相關資訊。 概念定義會使用 <table> 元素 這個檔案。

範例

以下是 country 概念的資料表範例 定義：

country, name
AD, Andorra
AF, Afghanistan
AI, Anguilla
AL, Albania
AO, Angola
AQ, Antarctica
AS, American Samoa

這個範例的運作原理如下：

  • 除非已指定對應，否則資料檔案的第一行 (欄) 標題) 必須與概念 ID 和適當的屬性完全相符 資料相關概念的 ID。不過，訂單 欄內的欄位不必與資料檔案中的欄相同 概念表在這種情況下，第一欄會與 country 概念，第二欄則與 資源 name
  • 屬性欄為選用項目；表示屬性沒有資料欄 系統就會假設每一列的值為未定義。 例如，省略 latitude 和 longitude 屬性，因此系統無法對應國家/地區。
  • 概念 ID 欄位的各個值 (在本例中為 country) 不得重複，且不得留空 (空白欄位為 1) 都屬於 0 或只有空白字元)。
  • 如果屬性值參照其他概念，值必須 空白，或參照概念的有效值。
  • 您不一定要以雙引號括住值， 包含半形逗號、雙引號或換行字元。
  • 逸出值的前面一個實名雙引號 另一個雙引號

配量資料檔案

Slice 資料檔案內含每個片段的相關資料。配量 定義會使用 <table ref="..."> 元素 需要參照 <table> 定義，而 這個檔案。

範例

以下的 .csv 檔案範例 上述 population_by_country 切片：

country, year, population
AF, 1960, 9616353
AF, 1961, 9799379
AF, 1962, 9989846
AF, 1963, 10188299

這個範例的運作原理如下：

  • 指標欄位為 population。欄位 country 和 year 是維度欄位。
  • 維度欄位的每個值皆不可空白。這包含時間 維度。指標欄位的值可以留空。空白值為 以無字元表示
  • 每個提及概念的欄標題 (例如第一個 上述範例的欄位參照 country 概念) 必須 與概念定義中該概念的專屬 ID 完全相符。
  • 不重複的維度值組合，例如AF, 2000, 只會出現一次
  • 同一個時間序列中的資料列 (亦即具有相同組合的資料列 所有維度值 (時間除外) 都必須分入一組，不過 不必另外排序

進階功能

多語言資料集

經過翻譯的 XML 值

xml:lang 屬性可以與 <value> 元素。此屬性 使用 標準 W3C，指定元素內容的語言 語言代碼。請注意，你可以自行選擇是否要使用這項功能；如果答案為「否」 會假設內容位於 xml:lang 屬性中 英語。

以下範例顯示了英文資料集 保加利亞文、加泰隆尼亞文和簡體中文：

<dspl ...>
  <info>
    <name>
      <value xml:lang="en">World Bank, World Development Indicators</value>
      <value xml:lang="bg">Световна банка, Индикатори за световно развитие</value>
      <value xml:lang="ca">Banc Mundial, Indicadors del desenvolupament mundial</value>
      <value xml:lang="zh-CN">国家/地区</value>
    </name>
    ...
  </info>

  <concepts>
    <concept id="country">
      <info>
        <name>
          <value xml:lang="en">Country</value>
          <value xml:lang="bg">Страна</value>
          <value xml:lang="ca">País</value>
          <value xml:lang="zh-CN">国家/地区</value>
        </name>
        ...
      </info>
      ...
    </concept>
    ...
  </concepts>

  ...
</dspl>

翻譯的屬性

在某些情況下，你可能會想提供超出翻譯範圍的翻譯 概念層級的中繼資料，並會額外 (或改為) 套用到個別 概念執行個體這個做法特別適合用來瞭解 資源 (例如名稱) 會因語言而異。

如要以多種語言提供這類值，請在 查看每個屬性/語言組合的對應定義表格。 然後，按照 將一組 <mapProperty xml:lang="..." ref="..." toColumn="..."> 元素新增至表格 概念的參考標記。

以下示範如何以英文命名國家/地區概念 西班牙文和法文：

<concepts>
  ...
  <concept id="country" extends="geo:location">
    ...
    <property id="name">
      <info>
        <name>
          <value>Name</value>
        </name>
        <description>
          <value>The official name of the country</value>
        </description>
      </info>
      <type ref="string" />
    </property>
    ...
    <table ref="countries_table">
      <mapProperty xml:lang="en" ref="name" toColumn="name_en"/>
      <mapProperty xml:lang="es" ref="name" toColumn="name_es"/>
      <mapProperty xml:lang="fr" ref="name" toColumn="name_fr"/>
    </table>
  </concept>
  ...
</concepts>

...

<tables>
  ...
  <table id="countries_table">
    <column id="country" type="string"/>
    <column id="name_en" type="string"/>
    <column id="name_es" type="string"/>
    <column id="name_fr" type="string"/>
    ...
  </table>
</tables>

countries_table 的 CSV 檔案就會包含 以下表單：

country,name_en,name_es,name_fr,...
...
US,United States of America,Estados Unidos de América,États-Unis d'Amérique,...
...

可對應概念

許多概念 (例如：郡、州、 城市) 擁有對應至地理位置的執行個體。DSPL 支援對這些實例進行地理編碼，以便在 Google 公開資料動畫地圖圖表。

如果您的概念是與世界國家/地區、美國各州或美國相同 即可直接連結至對應的 Google 標準網址 概念；不需要明確的地理編碼。詳情請參閱標準概念指南 詳細資料。

如果不是，您就必須將概念設為可對應。首先 使其從 geo:location 延伸：

<concept id="..." extends="geo:location">
  ...
</concept>

接著，您必須明確加入經緯度做為屬性：

<concept id="..." extends="geo:location">
  ...
  <property id="latitude"/>
  <property id="longitude"/>
</concept>

如此一來，這些值會指定為 概念定義資料表

概念關係

概念通常透過結構化的方式與其他概念相關。適用對象 單一洲別執行個體 國家/地區實體則可能包含多個 州或省的執行個體將這些變數編碼 資料集中繼資料內的關係能產生更豐富的視覺化內容 其他功能，例如顯示可收合的樹狀結構 可供選擇的地點

以下各節將說明 DSPL 結構定義

階層

概念階層在 DSPL 中使用 isParent="true" 屬性 子項概念的 <property> 標記，其中包含 父項概念中的例項 ID

舉例來說，Google 的美國郡概念 以下表單：

<concept id="us_county" extends="geo:location">
  <info>
    <name>
      <value xml:lang="en">County</value>
    </name>
    ...
  </info>
  ...
  <property id="state" concept="us_state" isParent="true"/>
  ...
  <data>
    <table ref="reference_us_counties"/>
  </data>
</concept>

支援資料表的 state 欄，當中 兩個字母的州/省代碼。這類中繼資料 公開資料瀏覽器，以階層形式顯示各州和郡的一項功能 讓使用者更輕鬆探索內容

請注意，一個概念可以有多個子項，但只能有一個子項 上層發布商。

對應

概念對應 (即概念對應，從基本上， 以 isMapping="true" 表示 屬性。property

指定一個概念對應後，前者即可沿用 後者的所有屬性和屬性在其他應用程式中 以用於「連結」個人地理概念 如 Google 標準地理區域資料集中所定義：

<concept id="my_country" extends="geo:location">
  <info>
    <name>
      <value xml:lang="en">Country</value>
    </name>
    ...
  </info>
  ...
  <property id="google_country_code" concept="geo:country" isMapping="true"/>
  <data>
    <table ref="countries_concept"/>
  </data>
</concept>

額外資訊

概念擴充功能是透過 extends 元素指定 對應的概念副檔名可用來 某個特定概念是另一個更廣泛概念的子類別 延伸概念會繼承其父項的所有屬性和屬性 也可以新增其他目標對象

例如，Google 的 currency 概念 unit:

<concept id="unit">
  ...
</concept>

<concept id="currency" extends="unit">
  <info>
    <name>
      <value xml:lang="en">Currency unit</value>
    </name>
    ...
  </info>
  ...
  <table ref="currency_table"/>
</concept>

請參閱概念 教學課程中的擴充功能，取得進一步的說明和範例。

提交資料集

如要將資料集提交至 Google Public Data Explorer，請按照下列步驟操作： 說明：

  1. 建立目錄。
  2. 將資料集 dspl 檔案儲存在您建立的目錄中。請務必 使用 .xml 副檔名
  3. 將任何本機 .csv 檔案儲存在同一個目錄中。屬於 您可以省略透過網址所參照的通訊協定。
  4. 壓縮目錄。
  5. 上傳資料集到 Google 公開資料 。

上傳並驗證資料集後，即可在簽署後測試 登入 Google 帳戶。您必須查看這項資訊，新的名稱才會發布 並且指出專案已經就緒