Skip to content

Commit

Permalink
Initial commit
Browse files Browse the repository at this point in the history
  • Loading branch information
Chris Metcalf committed Oct 18, 2012
0 parents commit 9156ae5
Show file tree
Hide file tree
Showing 3 changed files with 73 additions and 0 deletions.
19 changes: 19 additions & 0 deletions README.mkd
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Data Catalog Schema and API

The beginnings of [Socrata](http://www.socrata)'s proposed modifications to the proposed [DCAT](http://www.w3.org/TR/vocab-dcat/) and [Data Catalog Schema and Protocol](http://spec.datacatalogs.org/).

Our proposal is heavily based on the work previously done by the W3C on the [DCAT](http://www.w3.org/TR/vocab-dcat/) standard and CKAN's proposed modifications to that standard in the [Data Catalog Schema and Protocol](http://spec.datacatalogs.org/).

## Files of note:

- specification.mkd - The detailed spec (work currently in progress)
- notes.mkd - Various notes from our learnings
- examples/ - Examples of catalog entries and listings in different formats

## Contributing

If you'd like to contribute, please do! Send us a pull request and we'd be glad to consider any proposed modifications.

## License

Thia work is all licensed [Creative Commons By-Attribution 3.0](http://creativecommons.org/licenses/by/3.0/legalcode)
43 changes: 43 additions & 0 deletions examples/earthquakes.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
{
"id": "earthquakes",
"uri": "http://data.usgs.gov/datasets/earthquakes",
"title": "USGS Earthquake Reports",
"license": "http://creativecommons.org/publicdomain/zero/1.0/",
"author": "Chris Metcalf",
"maintainer": "Will Pugh",
"tags": ["earthquake", "usgs", "shake and bake"],
"spatial": {
"type": "Polygon",
"coordinates": [
[ [100.0, 0.0], [101.0, 0.0], [101.0, 1.0], [100.0, 1.0], [100.0, 0.0] ]
]
},
"temporal": "http://placetime.com/interval/gregorian/2012-06-15T19:31:00Z/P1Y",
"version": "23",
"metadata_modified": "2012-10-07T16:46:00+800",
"metadata_created": "2012-10-07T16:46:00+800",
"resources": [ {
"resource_type": "api",
"url" : "http://data.usgs.gov/resource/earthquakes",
"mimetype" : "application/json;application/rdf+xml;text/csv",
"apitype" : "rest/soda",
"last_modified" : "2012-10-07T16:46:00+800",
"name" : "SODA API for USGS Earthquakes Reports"
}, {
"resource_type": "file",
"url" : "http://data.usgs.gov/api/views/abcd-1234/rows.csv",
"mimetype" : "text/csv",
"last_modified" : "2012-10-07T16:46:00+800",
"name" : "CSV Export for USGS Earthquakes Reports",
"size" : "2048",
"hash" : "sha1:941e94956d5ff68d31381731ef6d4ba0fa23f3bd"
}, {
"resource_type": "file",
"url" : "http://data.usgs.gov/api/views/abcd-1234/rows.xlsx",
"mimetype" : "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"last_modified" : "2012-10-07T16:46:00+800",
"name" : "CSV Export for USGS Earthquakes Reports",
"size" : "2048",
"hash" : "sha1:28298d9bd04d49cae0a499ef584f5b42b3dc6348"
} ]
}
11 changes: 11 additions & 0 deletions notes.mkd
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# Possible modifications to different parts of the spec

## Dataset

- We "id" should be a URI to the /datasets/{id} resource catalog entry
- Should we eliminate "name"? It seems redundant with "title"
- Suggestion seemed to be use http://vocab.org/placetime/interval/gregorian/ for "temporal", so that's what we used
- Definately agree with the use of the GeoJSON "geometry" object type

## Resoruce

0 comments on commit 9156ae5

Please sign in to comment.