Linked Vocabulary API for the Earth Sciences Community AGU Fall Meeting 2014 Stephan Zednik Peter Fox Linyun Fu Patrick West Xiaogang Ma Overview CMSP & OCM Portals Vocabulary Problem Objectives Testbed Vocabulary SKOS Linked Data Linked Vocabulary API Outcomes IN32A-07 AGU Fall Meeting 2014 Background Ontology and Vocabulary development in the context of data portals for environmental inter-agency collaboration Coastal and Marine Spatial Planning (CMSP) Ocean and Coastal Mapping (OCM) Data tagged using a multitude of data vocabularies Numerous agencies Numerous communities Overlapping scopes IN32A-07 AGU Fall Meeting 2014 The Vocabulary Problem Data from numerous agencies using numerous vocabularies Semantic Equivalence? Scope? Varying state of vocabulary Representation Publication Usage Mapping? IN32A-07 AGU Fall Meeting 2014 Objectives Provide proof- of-concept to agencies on publishing and consuming formal data vocabularies on the web Representation Use existing model Be Semantic Access Open License Non-proprietary Format Resolvable Identifiers Service Text-based search Aggregations Filtering Reasoning Mapping Formally Defined Machine-readable IN32A-07 AGU Fall Meeting 2014 Linked Data Use URIs to denote things Use HTTP URIs so people can look up those names When someone looks up a URI provide useful information, using the standards (RDF*, SPARQL) Include links to other URIs so that they can discover more things IN32A-07 AGU Fall Meeting 2014 Testbed Vocabulary National Information Management Systems (NIMS) Data Categories Data categories for marine spatial planning Revised copy to be formally released under different name Source - Excel document 8 top-level categories 94 terms IN32A-07 AGU Fall Meeting 2014 Simple Knowledge Organization System (SKOS) Model for expressing concept schemes in RDF Low-cost solution for porting existing knowledge organization systems to the Semantic Web Supports mapping between concept schemes W3C Recommendation (2009) SKOS Primer -IN32A-07 AGU Fall Meeting 2014 SKOS Model IN32A-07 AGU Fall Meeting 2014 SKOS Concept Scheme Mapping IN32A-07 AGU Fall Meeting 2014 NIMS Data Categories SKOS rdf:type owl:NamedIndividual, skos:Concept ; skos:prefLabel "Threatened and Endangered ; skos:inScheme ; skos:narrower,. rdf:type owl:NamedIndividual, skos:Concept ; skos:prefLabel "State Listed Threatened and Endangered ; skos:inScheme. IN32A-07 AGU Fall Meeting 2014 Vocabulary Service Linked Data API Easy-to-use web interface for publishing linked data User-defined (read-only) RESTful API Declarative Design Query Parameters to control resource construction Out-of-the-box support for RDF, XML, JSON, HTML IN32A-07 AGU Fall Meeting 2014 Linked Vocabulary API URI Syntax /vocab/{vocab_id} /vocab/{vocab_id}/term/{term_id} Collections /vocabs /vocab/{vocab_id}/terms /vocab/{vocab_id}/term/{term_id}/related Text-based Search /vocab/{vocab_id}/terms?anyLabelContains={text} Mapping /vocab/{vocab_id}/term/{term_id}/closeMatch?inScheme.prefLabel={name} Query Parameters /vocab/{vocab_id}/terms?_properties=prefLabel,altLabel /vocab/{vocab_id}/terms?_page=2&_pageSize=25 For full API seeIN32A-07 AGU Fall Meeting 2014 Outcomes Proof-of-concept Publishing vocabularies as Linked Open Data using SKOS Development of vocabulary service SKOS-based RESTful API http://bit.ly/1IG8vGXhttp://bit.ly/1IG8vGX Service hosting preliminary NIMS Data Categories Vocabulary http://bit.ly/1zVd7Tohttp://bit.ly/1zVd7To IN32A-07 AGU Fall Meeting 2014 Next Steps Publish more vocabularies Publish vocabulary mappings Feedback from user community Iterate on API (especially vocab mapping) Possible Research Data Alliance (RDA) interest group on vocabulary services IN32A-07 AGU Fall Meeting 2014 Thanks CMSP/OCM Workshop Epimorphics Ltd. W3C SKOS Working Group IN32A-07 AGU Fall Meeting 2014 QUESTIONS/COMMENTS? Project URL:IN32A-07 AGU Fall Meeting 2014 Links This Presentation http://bit.ly/1Gim0KBhttp://bit.ly/1Gim0KB CMSPV Project Page http://tw.rpi.edu/web/project/CMSPVhttp://tw.rpi.edu/web/project/CMSPV CMSPV NIMS Linked Vocabulary API http://cmspv.tw.rpi.edu/elda/cmspv/vocab/nimshttp://cmspv.tw.rpi.edu/elda/cmspv/vocab/nims Linked Vocabulary API on Github https://github.com/tetherless-world/linked-vocabulary-apihttps://github.com/tetherless-world/linked-vocabulary-api W3C SKOS Primer http://www.w3.org/TR/skos-primer/http://www.w3.org/TR/skos-primer/ Linked Data Design Issues http://www.w3.org/DesignIssues/LinkedData.htmlhttp://www.w3.org/DesignIssues/LinkedData.html Linked Data API Specification https://code.google.com/p/linked-data-api/wiki/Specificationhttps://code.google.com/p/linked-data-api/wiki/Specification ELDA on Github https://github.com/epimorphics/eldahttps://github.com/epimorphics/elda IN32A-07 AGU Fall Meeting 2014 BACKUP SLIDES IN32A-07 AGU Fall Meeting 2014 CMSPV HTML View IN32A-07 AGU Fall Meeting 2014 CMSPV JSON { "format" : "linked-data-api", "version" : "0.2", "result" : {"_about" : "http://cmspv.tw.rpi.edu/rdf/cmspv/vocab/nims/term/0006.json", "definition" : "http://cmspv.tw.rpi.edu/rdf/cmspv/meta/vocab/_vocabulary/term/_term.json", "extendedMetadataVersion" : "http://cmspv.tw.rpi.edu/rdf/cmspv/vocab/nims/term/0006.json?_metadata=all", "primaryTopic" : {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0006", "inScheme" : {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims", "prefLabel" : "NIMS Data Categories"}, "label" : ["Cultural and Historic"], "narrower" : [{"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0026", "prefLabel" : "Locations of Artifacts Reflecting US Maritime History"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0027", "prefLabel" : "Areas + Resources of Cultural Significance to Native Peoples"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0028", "prefLabel" : "Important View-sheds"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0029", "prefLabel" : "Historically Significant Properties"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0030", "prefLabel" : "Protected Areas"} ], "narrowerTransitive" : [{"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0026", "prefLabel" : "Locations of Artifacts Reflecting US Maritime History"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0027", "prefLabel" : "Areas + Resources of Cultural Significance to Native Peoples"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0028", "prefLabel" : "Important View-sheds"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0029", "prefLabel" : "Historically Significant Properties"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0030", "prefLabel" : "Protected Areas"} ], "prefLabel" : "Cultural and Historic", "semanticRelation" : [{"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0026", "prefLabel" : "Locations of Artifacts Reflecting US Maritime History"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0027", "prefLabel" : "Areas + Resources of Cultural Significance to Native Peoples"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0028", "prefLabel" : "Important View-sheds"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0029", "prefLabel" : "Historically Significant Properties"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0030", "prefLabel" : "Protected Areas"} ], "topConceptOf" : {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims", "prefLabel" : "NIMS Data Categories"}, "type" : ["http://www.w3.org/2002/07/owl#NamedIndividual", "http://www.w3.org/2004/02/skos/core#Concept"]}, "type" : ["http://purl.org/linked-data/api/vocab#Page"]} } IN32A-07 AGU Fall Meeting 2014 SKOS (cont.) IN32A-07 AGU Fall Meeting 2014 5-Star Linked Open Data Make your stuff available on the web (whatever format) under an open license Make it available as structured data (e.g. Excel instead of image scan of a table) Use non-proprietary formats (e.g. CSV instead of Excel) Use URIs to denote things, so that people can point at your stuff Link your data to other data to provide contextIN32A-07 AGU Fall Meeting 2014 ELDA (cont.)IN32A-07 AGU Fall Meeting 2014 LDA Specification lva:vocabularyTermsEndpoint a api:ListEndpoint ; rdfs:comment " ; api:uriTemplate "/vocab/{vocabulary}/terms" ; api:exampleRequestPath "/vocab/nims/terms" ; api:variable [ api:name "scheme" ; api:value "{base}/vocab/{vocabulary}" ; api:type rdfs:Resource ; ] ; api:selector [ api:where "?item skos:inScheme ?scheme. ?item skos:prefLabel ?label." ; api:orderBy "?label" ; ] ;. IN32A-07 AGU Fall Meeting 2014