What is the schema.org model for offering Data Services and Continuous Feeds?

ashepherd commented 5 years ago

Data Service

{
  "@context": "http://schema.org/",
  "@id": "https://example-repository.org/data",
  "@type": "DataCatalog",
  "name": "My Catalog",
  "provider": {
     "@id": "https://example-repository.org",
     "@type": "Organization",
     "name": "Example Repository"
   },
  "offers": {
    "@type": "Offer",
    "itemOffered": [
      {
        "@id": "https://example-repository.org/services/opensearch",
        "@type": "WebAPI",
        "serviceType": "http://www.wikidata.org/entity/Q1294021",
        "url": "https://example-repository.org/services/opensearch",
        "name": "OpenSearch @ Example Repository",
        "documentation": "https://example-repository.org/services/docs/opensearch",
        "termsOfService": "https://example-repository.org/services/terms/opensearch",
        "provider": { "@id": "https://example-repository.org" }
      }
    ]
  }
}

Data Feeds (continuous data feeds)

{
  "@context": "http://schema.org/",
  "@id": "https://example-repository.org/data",
  "@type": "DataCatalog",
  "name": "My Catalog",
  "provider": {
     "@id": "https://example-repository.org",
     "@type": "Organization",
     "name": "Example Repository"
   },
  "offers": {
    "@type": "Offer",
    "itemOffered": [
      {
        "@id": "https://example-repository.org/data/continuous-stream-of-xyz",
        "@type": "DataFeed",
        "name": "Live streaming Data of XYZ",
        "url": "https://example-repository.org/data/continuous-stream-of-xyz",
        "provider": { "@id": "https://example-repository.org" }
      }
    ]
  }
}

ashepherd commented 5 years ago

How do we help folks describe their Data Catalog? from https://github.com/ESIPFed/science-on-schema.org/blob/master/guides/DataRepository.md#describing-a-repositorys-data-collections

If there's a separate web page for their Data Services, we cna have that page marked up as a schema:DataCatalog
If there is no page, but they have services, do we make the homepage a @graph of two elements: [Organization, DataCatalog].

To make Services and DataFeeds actionable, we still need to use the schema:potentialAction. Note: Ignore the Service and ServiceChannel in the diagram below, but focusing in on the schema:potentialAction pattern. from https://github.com/ESIPFed/science-on-schema.org/blob/master/guides/DataRepository.md#describing-a-repositorys-services

ashepherd commented 5 years ago

For describing a DataService's type, see https://github.com/earthcubearchitecture-project418/p419dcatservices/issues/2 for WikiData service types

dr-shorthair commented 4 years ago

DCAT DataService

earthcubearchitecture-project418 / p419dcatservices

What is the schema.org model for offering Data Services and Continuous Feeds? #3