Skip to content

Introduction to SensorThingsAPI data model

Hylke van der Schaaf edited this page Dec 15, 2023 · 6 revisions

A short intro to OGC SensorThingsAPI

The OGC SensorThings API was originally designed to be an API for exchanging observational data in the IoT domain, but it quickly shown itself to be a full successor to the OGC Sensor Observation Service. The SensorThings API in short:

  • A standard for exchanging sensor data and metadata
    • Historic data & current data
    • RESTful + JSON Encoded, with a powerful querying mechanism (based on OASIS OData)
    • Supporting ISO MQTT messaging
  • Easy to use & understandable: Discoverable with just a web browser

Here is a diagram showing the different classes from OGC SensorThings API Part 1: Sensing Version 1.1

image

For those who are familiar with ISO 19156 (aka OGC OMS), you will find those data models have a lot in common.

The main class to consider is the Observation that provides the result that was obtained at a specific date, location, following a particular procedure. The ObservedProperty, Sensor, Thing and FeatureOfInterest enable the contextualization of those parameters.

The main difference with OMS relies in the fact that STA introduces the Datastream concept as a way to group observations that "come together".

This is very common with repeated measurements like time series, or measurements made along a trajectory. The Datastream enables grouping those observations and avoids repeating parameters that remain unchanged like the Sensor or Observed Property.

This concept is explained further in this video: https://www.youtube.com/watch?v=bYDSgs2fKLk

Further documentation of the OGC SensorThings API:

GeotechIE proposes to reuse and extend this data model to accommodate the provision of borehole data. See STA Borehole Model

Introduction

Geotech concepts

Book A concepts

Hole in the ground

For the activity of observation and its results

For the activity of sampling and preparation

Book B concepts

For Geological Modeling

For Hydrogeological Modeling

For Geotechnical Modeling

For Hazard Modeling

Book C concepts

ISO & OGC GeoTech Model

General considerations

ISO19148 and ISO19156

SensorThingsAPI datamodel

GeoSciML

GroundWaterML2

EPOS WP15

LandInfra & InfraGML

INSPIRE Theme III: Natural Risk Zone

Implementation guide, resources and examples

Exposing geotech investigation data with OGC SensorThings API

Vocabulary and codelist for geotech

Conclusions

Clone this wiki locally