Merge pull request #2 from pzaborowski/master

Sensor and Feature

_sources/my-building-block/bblock.json → _sources/FeatureOfInterest/bblock.json

@@ -1,18 +1,18 @@
 {
   "$schema": "https://raw.githubusercontent.com/opengeospatial/bblocks-postprocess/master/ogc/bblocks/metadata-schema.yaml",
-  "name": "My Building Block",
-  "abstract": "This Building Block serves as a template to create new ones",
+  "name": "SensorThings API FeatureOfInterest (FOI)",
+  "abstract": "Representation of the result of the FeatureOfInterest. ",
   "status": "under-development",
-  "dateTimeAddition": "2023-04-05T00:00:00Z",
+  "dateTimeAddition": "2024-02-09T00:00:00Z",
   "itemClass": "schema",
   "register": "ogc-building-block-register",
   "version": "0.1",
-  "dateOfLastChange": "2023-04-05",
+  "dateOfLastChange": "2024-02-09",
   "link": "https://github.com/opengeospatial/bblock-template",
   "sources": [
     {
-      "title": "Sample source document",
-      "link": "https://example.com/sources/1"
+      "title": "OGC SensorThings API Part 1: Sensing Version 1.1",
+      "link": "https://docs.ogc.org/is/18-088/18-088.html"
     }
   ],
   "maturity": "mature",

_sources/FeatureOfInterest/context.jsonld

@@ -0,0 +1,41 @@
+{
+  "@context": [
+    {
+      "sta": "https://schemas.opengis.org/sta/def/core#",
+      "sosa": "https://www.w3.org/TR/vocab-ssn/#",
+      "dct": "http://purl.org/dc/terms/",
+      "dcat": "https://w3c.github.io/dxwg/dcat/",
+      "skos": "http://www.w3.org/2004/02/skos/core#",
+      "iana": "https://www.iana.org/assignments/media-types/",
+      "rel": "http://www.iana.org/assignments/relation/",
+      "geojson": "https://purl.org/geojson/vocab#"
+    },
+    {
+      "@iot.id": "@id",
+      "@iot.selfLink": "sta:selfLink",
+      "name": "dct:title",
+      "description": "dct:description",
+      "encodingType": "dcat:mediaType",
+      "feature": {
+        "@id": "geojson:Feature",
+        "@context": {
+          "type": "@type",
+          "coordinates": {
+            "@container": "@list",
+            "@id": "geojson:coordinates"
+          }
+        }
+      }
+    },
+    {
+      "LineString": "geojson:LineString",
+      "MultiLineString": "geojson:MultiLineString",
+      "MultiPoint": "geojson:MultiPoint",
+      "MultiPolygon": "geojson:MultiPolygon",
+      "Point": "geojson:Point",
+      "Polygon": "geojson:Polygon",
+      "geometry": "geojson:geometry",
+      "[email protected]": "sta:Observation"
+    }
+  ]
+}

_sources/FeatureOfInterest/description.md

@@ -0,0 +1,16 @@
+## What it represents
+
+An Observation results in a value being assigned to a phenomenon. The phenomenon is a property of a feature, the latter being the FeatureOfInterest of the Observation [OGC and ISO 19156:2011]. In the context of the Internet of Things, many Observations’ FeatureOfInterest can be the Location of the Thing. For example, the FeatureOfInterest of a wifi-connect thermostat can be the Location of the thermostat (i.e., the living room where the thermostat is located in). In the case of remote sensing, the FeatureOfInterest can be the geographical area or volume that is being sensed.
+
+### Limitations
+For compliance with SwaggerHub where the schema can be referred:
+- type of id is not specified, while it shall be string or number
+- type of feature property is not specified, while it shall be string or object
+
+> Videri vias quid Ausoniae sua flores ante, reminiscitur fuit est. Semel
+> [hectora](http://silvaque.org/) peregrinaeque rudem exercent in, Troiana si
+> Asida instabilesque somno sed.
+
+## References
+
+Requirements: [http://www.opengis.net/spec/iot_sensing/1.1/req/datamodel/feature-of-interest](https://docs.ogc.org/is/18-088/18-088.html#featureofinterest)

_sources/FeatureOfInterest/examples.yaml

@@ -0,0 +1,5 @@
+- title: FeatureOfInterest basic example.
+  base-uri: http://w3id.org/ogcincubator/bblocks-sta/
+  snippets:
+    - language: json
+      ref: examples/FeatureOfInterest.json

_sources/FeatureOfInterest/examples/FeatureOfInterest.json

@@ -0,0 +1,16 @@
+{
+  "@iot.id": 1,
+  "@iot.selfLink": "http://example.org/v1.1/FeaturesOfInterest(1)",
+  "[email protected]": "FeaturesOfInterest(1)/Observations",
+
+  "name": "Weather Station YYC.",
+  "description": "This is a weather station located at the Calgary Airport.",
+  "encodingType": "application/geo+json",
+  "feature": {
+    "type": "Feature",
+    "geometry":{
+      "type": "Point",
+      "coordinates": [-114.06,51.05]
+    }
+  }
+}

_sources/FeatureOfInterest/schema.yaml

@@ -0,0 +1,36 @@
+"$schema": "http://json-schema.org/draft-04/schema#"
+title: FeatureOfInterest object
+description: "Schema for Sensor things API 1.1 FeatureOfInterest"
+type: object
+required:
+  - "@iot.id"
+  - "@iot.selfLink"
+  - name
+  - description
+  - encodingType
+  - feature
+  - [email protected]
+properties:
+  "@iot.id":
+      description: The Id of the Feature
+  "@iot.selfLink":
+      type: string
+      description: The direct link to the entity
+  name:
+    type: string
+    description: A property provides a label for FeatureOfInterest entity, commonly a descriptive name.
+  description:
+    type: string
+    description: The description about the FeatureOfInterest.
+  encodingType:
+    type: string
+    description: The encoding type of the feature property. Its value is one of the ValueCode enumeration (see https://docs.ogc.org/is/18-088/18-088.html#tab-encodingtype-codes for the available ValueCode)..
+    const: 'application/geo+json'
+  feature:
+    description: The detailed description of the feature. The data type is defined by encodingType.
+  properties:
+    type: object
+    description: optional properties for the feature.
+  [email protected]:
+    type: string
+    description: Reference link to the Observations.

_sources/Observation/context.jsonld

@@ -1,7 +1,7 @@
 {
   "@context": [{
     "sta": "https://schemas.opengis.org/sta/def/core#",
-    "sosa": "https://www.w3.org/TR/vocab-ssn/",
+    "sosa": "https://www.w3.org/TR/vocab-ssn/#",
     "rel": "http://www.iana.org/assignments/relation/"},
 	{
     "@iot.id": "@id",
@@ -11,8 +11,8 @@
       "resultQuality": "sta:resultQuality",
       "resultTime": "sosa:resultTime",
       "validTime": "sta:validTime",
-    "Datastream": "sta:DataStrem",
-    "FeatureOfInterest": "sosa:hasFeatureOfInterest"
+      "Datastream@iot.navigationLink": "sta:DataStream",
+      "FeatureOfInterest@iot.navigationLink": "sosa:hasFeatureOfInterest"
     }
 	]
 

_sources/Observation/description.md

@@ -1,6 +1,10 @@
 ## What is represents
 
-Observation is an act of measuring or otherwise determining the value of a property. [OGC 10-004r3 / ISO 19156:2011]
+Observation is an act of measuring or otherwise determining the value of a property. [OGC 10-004r3 / ISO 19156:2011].
+
+### Limitations
+For compliance with SwaggerHub where the schema can be referred:
+- type of id is not specified, while it shall be string or number
 
 
 > Videri vias quid Ausoniae sua flores ante, reminiscitur fuit est. Semel

_sources/Observation/schema.yaml

@@ -17,10 +17,6 @@ properties:
     type: string
     description: The time when the observation happened. or Time Interval string (e.g., 2010-12-23T10:20:00.00-07:00 or 2010-12-23T10:20:00.00-07:00/2010-12-23T12:20:00.00-07:00)
   result:
-    type:
-      - string
-      - number
-      - boolean
     description: The estimated value of the observed property. Type depends on the observationType defined in the associated Datastream
   resultQuality:
     type: string

_sources/Sensor/bblock.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://raw.githubusercontent.com/opengeospatial/bblocks-postprocess/master/ogc/bblocks/metadata-schema.yaml",
+  "name": "SensorThings API Sensor",
+  "abstract": "A Sensor is an instrument that observes a property or phenomenon with the goal of producing an estimate of the value of the property.",
+  "status": "under-development",
+  "dateTimeAddition": "2024-02-10T00:00:00Z",
+  "itemClass": "schema",
+  "register": "ogc-building-block-register",
+  "version": "0.1",
+  "dateOfLastChange": "2024-02-10",
+  "link": "https://github.com/opengeospatial/bblock-template",
+  "sources": [
+    {
+      "title": "OGC SensorThings API Part 1: Sensing Version 1.1",
+      "link": "https://docs.ogc.org/is/18-088/18-088.html"
+    }
+  ],
+  "maturity": "mature",
+  "scope": "unstable",
+  "tags": ["templates"]
+}

_sources/Sensor/context.jsonld

@@ -0,0 +1,19 @@
+{
+  "@context": [{
+    "sta": "https://schemas.opengis.org/sta/def/core#",
+    "sosa": "https://www.w3.org/TR/vocab-ssn/#",
+    "rel": "http://www.iana.org/assignments/relation/"},
+	{
+    "@iot.id": "@id",
+      "@iot.selfLink": "sta:selfLink",
+      "phenomenonTime": "sosa:phenomenonTime",
+      "result": "sosa:hasSimpleResult",
+      "resultQuality": "sta:resultQuality",
+      "resultTime": "sosa:resultTime",
+      "validTime": "sta:validTime",
+    "Datastream": "sta:DataStrem",
+    "FeatureOfInterest": "sosa:hasFeatureOfInterest"
+    }
+	]
+
+}

_sources/Sensor/description.md

@@ -0,0 +1,16 @@
+## What is represents
+
+Observation is an act of measuring or otherwise determining the value of a property. [OGC 10-004r3 / ISO 19156:2011]
+
+### Limitations
+For compliance with SwaggerHub where the schema can be referred:
+- type of id is not specified, while it shall be string or number
+- type of metadata property is not specified, while it shall be string or object
+
+> Videri vias quid Ausoniae sua flores ante, reminiscitur fuit est. Semel
+> [hectora](http://silvaque.org/) peregrinaeque rudem exercent in, Troiana si
+> Asida instabilesque somno sed.
+
+## References
+
+Requirements: [http://www.opengis.net/spec/iot_sensing/1.1/req/datamodel/observation](https://docs.ogc.org/is/18-088/18-088.html#observation)

_sources/Sensor/examples.yaml

@@ -0,0 +1,5 @@
+- title: Observation whose Datastream has an ObservationType of OM_Measurement. A result’s data type is defined by the observationType.
+  base-uri: http://w3id.org/ogcincubator/bblocks-sta/
+  snippets:
+    - language: json
+      ref: examples/Observation.json

_sources/Sensor/examples/Sensor.json

@@ -0,0 +1,9 @@
+{
+  "@iot.id": 1,
+  "@iot.selfLink": "http://example.org/v1.1/Sensors(1)",
+  "[email protected]": "Sensors(1)/Datastreams",
+  "name": "TMP36",
+  "description": "TMP36 - Analog Temperature sensor",
+  "encodingType": "application/pdf",
+  "metadata": "http://example.org/TMP35_36_37.pdf"
+}

_sources/Sensor/schema.yaml

@@ -0,0 +1,27 @@
+"$schema": "http://json-schema.org/draft-04/schema#"
+title: Sensor object
+description: "Schema for Sensor things API 1.3 Observation"
+type: object
+properties:
+  "@iot.id":
+      description: The Id of the sensor
+  "@iot.selfLink":
+      type: string
+      description: The direct link to the entity
+  properties:
+    type: object
+    description: A JSON Object containing user-annotated properties as key-value pairs.
+  name:
+    type: string
+    description: A property provides a label for Sensor entity, commonly a descriptive name.
+  description:
+    type: string
+    description: The description of the Sensor entity.
+  encodingType:
+    type: string
+    description: The encoding type of the metadata property. Its value is one of the ValueCode enumeration (see Table 15 for the available ValueCode).
+  metadata:
+    description: The detailed description of the Sensor or system. The metadata type is defined by encodingType.
+  [email protected]:
+    type: string
+    description: Reference link to the DataStream Definition.