WebSchemas/Datasets

From W3C Wiki

Revision as of 01:15, 7 December 2012

Overview

This page discusses a proposal extending schema.org for describing datasets and data catalogs. For additional information, see this demo page. Comments on this proposal are welcome.

Status

We have a detailed proposal here, and something in this direction is a strong candidate for official addition to schema.org.

The natural next steps before finalizing the addition are:

• some indication from potential publishers that there is willingness to adopt, and that the design is a good fit to existing sites/content
• some positive indication from relevant experts (eg. open gov data publishers; from W3C's Government Linked Data group or others) that the schema has had some careful review. Comments can be here in the Wiki, to the public-vocabs@w3.org list (see details at WebSchemas page), or passed along via mail to danbri@google.com.

Vocabulary

The Datasets extension introduces three new types, with associated properties:

• Thing > CreativeWork > Dataset: a body of structured information describing some topic(s) of interest
  • catalog(DataCatalog): the data catalog which contains a dataset
  • distribution(DataDownload): a downloadable form of this dataset, at a specific location, in a specific format
  • keyword(Text): a keyword describing a dataset
  • spatial(Place): the range of spatial applicability of a dataset, e.g. for a dataset of New York weather, the state of New York
  • temporal(Date): the range of temporal applicability of a dataset, e.g. for a 2011 census dataset, the year 2011 (in ISO 8601 time interval format)
• Thing > CreativeWork > DataCatalog: a collection of datasets
  • dataset(Dataset): a dataset contained in a catalog
• Thing > CreativeWork > MediaObject > DataDownload: a dataset in downloadable form

Example

Microdata markup

<div itemscope="itemscope" itemtype="http://schema.org/Dataset">

    <span itemprop="name">
        <a href="http://www.datasf.org/story.php?title=seismic-hazard-zones-">
            <b>Seismic Hazard Zones</b>
        </a>
    </span>

    (<span itemprop="temporal">2011</span>)

    <div>
        <meta itemprop="url" content="http://www.datasf.org/story.php?title=seismic-hazard-zones-"/>
        <span itemprop="description">The dataset represents the Liquefaction and Landslide Zones as determined by the California Dept. of Conservation
Division of Mines and Geology. Liquefaction is the transformation of a confined layer of sandy or silty water-satuated material into a liquid-like state
because of earthquake shaking. San Francisco Building Code Section1804.5 requires a geotechnical investigation in seismic hazard zones.</span>
    </div>

    <div itemprop="spatial" itemscope="itemscope" itemtype="http://schema.org/Country" itemid="http://dbpedia.org/resource/United_States"><i>Country:</i>
        <a href="http://en.wikipedia.org/wiki/United_States">
            <span itemprop="name">United States</span>
        </a>
    </div>

    <div itemprop="publisher" itemscope="itemscope" itemtype="http://schema.org/Organization"><i>Publisher:</i>
        <span itemprop="name">Department of Technology</span>
        <span itemprop="email">dot at example dot org</span>
    </div>

    <div><i>Topics:</i>
        <span itemprop="about" itemscope="itemscope" itemtype="http://schema.org/Thing" itemid="http://dbpedia.org/resource/Seismic_hazard">
            <a href="http://en.wikipedia.org/wiki/Seismic_hazard"><span itemprop="name">seismic hazard</span></a>
        </span>
    </div>

    <div><i>Keywords:</i>
        <span itemprop="keyword"><span itemscope="itemscope" itemtype="http://schema.org/Text">layers</span></span>,
        <span itemprop="keyword"><span itemscope="itemscope" itemtype="http://schema.org/Text">geography</span></span>,
        <span itemprop="keyword"><span itemscope="itemscope" itemtype="http://schema.org/Text">maps</span></span>,
        <span itemprop="keyword"><span itemscope="itemscope" itemtype="http://schema.org/Text">gis</span></span>
    </div>

    <div itemprop="license" itemscope="itemscope" itemtype="http://schema.org/Webpage"><i>License:</i>
        <a href="http://opendatacommons.org/licenses/pddl/1.0/">
            <span itemprop="name">ODC Public Domain Dedication and Licence (PDDL)</span>
        </a>
        <meta itemprop="url" content="http://opendatacommons.org/licenses/pddl/1.0/" />
    </div>

    <div itemprop="distribution" itemscope="itemscope" itemtype="http://schema.org/DataDownload"><i>Download:</i>
        <a href="http://data-gov.tw.rpi.edu/raw/1200/data-1200.nt.gz">
            <meta itemprop="encodingFormat" content="text/plain" />
            <meta itemprop="contentUrl" content="http://data-gov.tw.rpi.edu/raw/1200/data-1200.nt.gz" />
            <meta itemprop="inLanguage" content="en" />
            <span itemprop="description">compressed N-Triples dump</span>,
            <span itemprop="datePublished" content="2011-08-12">August 12, 2011</meta>
            <span itemprop="contentSize" content="13.9">(13.97MB)</span>
	</a>
    </div>

</div>

embedded data

Item 
type: http://schema.org/dataset	
name: Seismic Hazard Zones
temporal: 2011
url: http://www.datasf.org/story.php?title=seismic-hazard-zones-
description: The dataset represents the Liquefaction and Landslide Zones as determined by the California Dept. of Conservation Division of Mines and Geology. Liquefaction is the transformation of a confined...
spatial: Item 1
publisher: Item 2
about: Item 3
keyword: layers
keyword: geography
keyword: maps
keyword: gis
license: Item 4
distribution: Item 5

Item 1
type: http://schema.org/country
name: United States

Item 2
type: http://schema.org/organization
name: Department of Technology
email: dot at example dot org

Item 3
type: http://schema.org/thing
name: seismic hazard

Item 4
type: http://schema.org/webpage
name: ODC Public Domain Dedication and Licence (PDDL)
url: http://opendatacommons.org/licenses/pddl/1.0/

Item 5
type: http://schema.org/datadownload
encodingformat: text/plain
contenturl: http://data-gov.tw.rpi.edu/raw/1200/data-1200.nt.gz
inlanguage: en
description: compressed N-Triples dump
datepublished: 2011-08-12
contentsize: 13.9

equivalent RDFa 1.1 markup

<div vocab="http://schema.org/" prefix="dcat: http://www.w3.org/ns/dcat#"  about="http://logd.tw.rpi.edu/source/datasf-org/dataset/catalog/datasf.org/version/2011-Jun-07/thing_89" typeof="Dataset dcat:Dataset">
 
    <span property="name"><b><a href="http://www.datasf.org/story.php?title=seismic-hazard-zones-">Seismic Hazard Zones</a></b></span>

    (<span property="temporal">2011</span>)

    <div property="description">The dataset represents the Liquefaction and Landslide Zones as determined by the California Dept. of Conservation
Division of Mines and Geology. Liquefaction is the transformation of a confined layer of sandy or silty water-saturated material into a liquid-like state
because of earthquake shaking. San Francisco Building Code Section1804.5 requires a geotechnical investigation in seismic hazard zones.</div>

    <div rel="spatial" resource="http://dbpedia.org/resource/United_States"><i>Country:</i>
        <a href="http://dbpedia.org/resource/United_States">
            <span about="http://dbpedia.org/resource/United_States" typeof="Country">
                <span property="name">United States</span>
            </span>
        </a>
    </div>

    <div rel="publisher"><i>Publisher:</i>
        <span typeof="Organization">
            <span property="name">Department of Technology</span>
	    (<span property="email">dot at example dot org</span>)
        </span>
    </div>

    <div><i>Topics:</i>
        <span rel="about" resource="http://dbpedia.org/resource/Seismic_hazard">
            <a href="http://en.wikipedia.org/wiki/Seismic_hazard">
                <span property="name">seismic hazard</span></a>
        </span>
    </div>

    <div><i>Keywords:</i>
        <span property="keyword">layers</span>,
        <span property="keyword">geography</span>,
        <span property="keyword">maps</span>,
        <span property="keyword">gis</span>
    </div>

    <div rel="license"><i>License:</i>
    	<a href="http://opendatacommons.org/licenses/pddl/1.0/">
	<span typeof="Webpage">
	    <span property="name">ODC Public Domain Dedication and Licence (PDDL)</span>
	    <meta property="url" content="http://opendatacommons.org/licenses/pddl/1.0/"/>
	</span>
	</a>
    </div>
    
    <div rel="distribution"><i>Download:</i>
        <a href="http://data-gov.tw.rpi.edu/raw/1200/data-1200.nt.gz">
        <span typeof="DataDownload">
            <meta property="encodingFormat" content="text/plain" />
            <meta property="contentUrl" content="http://data-gov.tw.rpi.edu/raw/1200/data-1200.nt.gz" />
            <meta property="inLanguage" content="en" />
            <span property="description">compressed N-Triples dump</span>,
            <meta property="datePublished" content="2011-08-12">August 12, 2011</meta>
            <meta property="contentSize" content="13.9">(13.97MB)</span>
	</span>
	</a>
    </div>

</div>

RDFa 1.1 Lite markup

<div vocab="http://schema.org/" prefix="dcat: http://www.w3.org/ns/dcat#"  about="http://logd.tw.rpi.edu/source/datasf-org/dataset/catalog/datasf.org/version/2011-Jun-07/thing_89" typeof="Dataset dcat:Dataset">

    <span property="name"><b><a href="http://www.datasf.org/story.php?title=seismic-hazard-zones-">Seismic Hazard Zones</a></b></span>

    (<span property="temporal">2011</span>)

    <div property="description">The dataset represents the Liquefaction and Landslide Zones as determined by the California Dept. of Conservation
Division of Mines and Geology. Liquefaction is the transformation of a confined layer of sandy or silty water-saturated material into a liquid-like state
because of earthquake shaking. San Francisco Building Code Section1804.5 requires a geotechnical investigation in seismic hazard zones.</div>

    <div><i>Keywords:</i>
        <span property="keyword">layers</span>,
        <span property="keyword">geography</span>,
        <span property="keyword">maps</span>,
        <span property="keyword">gis</span>
    </div>

</div>

Related vocabularies

• Data Catalog Vocabulary (DCAT)
• Asset Description Metadata Schema (ADMS)
• Vocabulary of Interlinked Datasets (VoID)
• vocabulary of the International Open Government Search service (derived from the above)
• RDF Data Cube Vocabulary

Mappings

This table maps Datasets extension types and properties (including supporting schema.org vocabulary) to and from their approximate equivalents in DCAT, ADMS, and VoID. Note that ADMS refers to a vocabulary, RADion, designed to act as a common substrate for all such languages - a role that perhaps schema.org could fulfill. The 'official release' of RADion is on the European Commission's Joinup platform and a namespace has been reserved on w3.org however, for ease of access, an unofficial easy-access copy is also available directly in HTML and RDF (renders with XSLT).

See also

• Closing In On A Million Open Government Data Sets