gost_deepinsert.md

SensorThings Deep Insert API

With the Deep Insert functionality of SensorThings API its possible to create multiple entities in one request.

• Create Thing with Location and Datastream

$ curl -X POST -H "content-type:application/json" http://localhost:8080/v1.0/Things

body:

{
    "name": "lantern",
    "description": "camping lantern",
    "properties": {
        "property1": "it’s waterproof",
        "property2": "it glows in the dark",
        "property3": "it repels insects"
    },
    "Locations": [{
        "name": "bla",
        "description": "my backyard",
        "encodingType": "application/vnd.geo+json",
        "location": {
            "type": "Point",
            "coordinates": [-117.123,
            54.123]
        }
    }],
    "Datastreams": [{
        "name": "DS1",
        "unitOfMeasurement": {
            "name": "Celsius",
            "symbol": "C",
            "definition": "http://www.qudt.org/qudt/owl/1.0.0/unit/Instances.html#Celsius"
        },
        "description": "Temperature measurement",
        "observationType": "http://www.opengis.net/def/observationType/OGC-OM/2.0/OM_Measurement",
        "ObservedProperty": {
            "name": "Temperature",
            "definition": "http://www.qudt.org/qudt/owl/1.0.0/quantity/Instances.html#Temperature",
            "description": "Temperature of the camping site"
        },
        "Sensor": {
            "name": "This is a name",
            "description": "SensorUp Tempomatic 2000",
            "encodingType": "application/pdf",
            "metadata": "Calibration date:  Jan 1, 2014"
        }
    }]
}

• Create Datastream with ObservedProperty and Sensor for Thing.@iot_id=1

$ curl -X POST -H "content-type:application/json" http://localhost:8080/v1.0/Datastreams

body:

{
    "name": "DS3",
    "unitOfMeasurement": {
            "name": "Celsius",
            "symbol": "C",
            "definition": "http://www.qudt.org/qudt/owl/1.0.0/unit/Instances.html#Celsius"
        },
        "description": "Temperature measurement",
        "observationType": "http://www.opengis.net/def/observationType/OGC-OM/2.0/OM_Measurement",
        "ObservedProperty": {
            "name": "Temperature",
            "definition": "http://www.qudt.org/qudt/owl/1.0.0/quantity/Instances.html#Temperature",
            "description": "Temperature of the camping site"
        },
        "Sensor": {
            "name": "My Sensor",
            "description": "SensorUp Tempomatic 1000-b",
            "encodingType": "application/pdf",
            "metadata": "Calibration date:  Jan 11, 2015"
        },
         "Thing": {"@iot.id": "1"}
}

$ curl -X POST -H "content-type:application/json" http://localhost:8080/v1.0/Things

Create a Thing with Location and Datastream and Observations

{
    "name": "lantern",
    "description": "camping lantern",
    "properties": {
        "property1": "it’s waterproof",
        "property2": "it glows in the dark",
        "property3": "it repels insects"
    },
    "Locations": [{
        "name": "bla",
        "description": "my backyard",
        "encodingType": "application/vnd.geo+json",
        "location": {
            "type": "Point",
            "coordinates": [-117.123,
            54.123]
        }
    }],
    "Datastreams": [{
        "name": "DS1",
        "unitOfMeasurement": {
            "name": "Celsius",
            "symbol": "C",
            "definition": "http://www.qudt.org/qudt/owl/1.0.0/unit/Instances.html#Celsius"
        },
        "description": "Temperature measurement",
        "observationType": "http://www.opengis.net/def/observationType/OGC-OM/2.0/OM_Measurement",
        "ObservedProperty": {
            "name": "Temperature",
            "definition": "http://www.qudt.org/qudt/owl/1.0.0/quantity/Instances.html#Temperature",
            "description": "Temperature of the camping site"
        },
        "Sensor": {
            "name": "This is a name",
            "description": "SensorUp Tempomatic 2000",
            "encodingType": "application/pdf",
            "metadata": "Calibration date:  Jan 1, 2014"
        },
        "Observations": [
                {
                  "phenomenonTime": "2015-04-13T00:00:00Z",
                  "resultTime" : "2015-04-13T00:00:05Z",
                  "result" : 38
                }
            ]
    }]
}

• Create Observation with FeatureOfInterest

$ curl -X POST  -H "content-type:application/json" http://localhost:8080/v1.0/Observations

body:

{
  "phenomenonTime": "2015-04-13T00:00:00+02:00",
  "result" : 38,
  "Datastream":{"@iot.id":"2"},
  "FeatureOfInterest": {
    "name": "Awesome FOI",
    "description": "Underground Air Quality in NYC train tunnels",
    "encodingType": "application/vnd.geo+json",
    "feature": {
        "coordinates": [51.08386,-114.13036],
        "type": "Point"
      }
  }
}