dev.sensorthings.multiObservation

sensorthings.dev

Documentation

A composite observation bundling multiple co-produced results from a single act of sensing. Each entry carries its own ObservedProperty, unit, and scale metadata. Use this instead of separate Observations when the results are genuinely co-produced (e.g. wave statistics from spectral processing) and have no independent existence.

main record

A composite observation bundling multiple co-produced results from a single act of sensing. Each entry carries its own ObservedProperty, unit, and scale metadata. Use this instead of separate Observations when the results are genuinely co-produced (e.g. wave statistics from spectral processing) and have no independent existence.

Record Key any Any valid record key

Properties

derivedFrom array of string at-uri Optional

AT-URIs of source observations or datastreams

maxLength: 16 items
entries array of ref #multiObservationEntry Required

Array of co-produced result entries

maxLength: 32 items
phenomenonTime string datetime Required

Time the phenomenon was observed. Start of interval if phenomenonTimeEnd is present.

phenomenonTimeEnd string datetime Optional

End of observation interval. For wave statistics, this is the end of the burst window.

resultQuality string Optional

Quality flag applying to the composite observation as a whole

maxLength: 64 bytes
Known values: dev.sensorthings.quality#good, dev.sensorthings.quality#suspect, dev.sensorthings.quality#missing
resultTime string datetime Optional

Time the results became available

sensor string at-uri Required

AT-URI of the dev.sensorthings.sensor record (the instrument or process that co-produced these results)

thing string at-uri Required

AT-URI of the dev.sensorthings.thing record

View raw schema 
{
  "description": "A composite observation bundling multiple co-produced results from a single act of sensing. Each entry carries its own ObservedProperty, unit, and scale metadata. Use this instead of separate Observations when the results are genuinely co-produced (e.g. wave statistics from spectral processing) and have no independent existence.",
  "key": "any",
  "record": {
    "properties": {
      "derivedFrom": {
        "description": "AT-URIs of source observations or datastreams",
        "items": {
          "format": "at-uri",
          "type": "string"
        },
        "maxLength": 16,
        "type": "array"
      },
      "entries": {
        "description": "Array of co-produced result entries",
        "items": {
          "ref": "#multiObservationEntry",
          "type": "ref"
        },
        "maxLength": 32,
        "type": "array"
      },
      "phenomenonTime": {
        "description": "Time the phenomenon was observed. Start of interval if phenomenonTimeEnd is present.",
        "format": "datetime",
        "type": "string"
      },
      "phenomenonTimeEnd": {
        "description": "End of observation interval. For wave statistics, this is the end of the burst window.",
        "format": "datetime",
        "type": "string"
      },
      "resultQuality": {
        "description": "Quality flag applying to the composite observation as a whole",
        "knownValues": [
          "dev.sensorthings.quality#good",
          "dev.sensorthings.quality#suspect",
          "dev.sensorthings.quality#missing"
        ],
        "maxLength": 64,
        "type": "string"
      },
      "resultTime": {
        "description": "Time the results became available",
        "format": "datetime",
        "type": "string"
      },
      "sensor": {
        "description": "AT-URI of the dev.sensorthings.sensor record (the instrument or process that co-produced these results)",
        "format": "at-uri",
        "type": "string"
      },
      "thing": {
        "description": "AT-URI of the dev.sensorthings.thing record",
        "format": "at-uri",
        "type": "string"
      }
    },
    "required": [
      "thing",
      "sensor",
      "phenomenonTime",
      "entries"
    ],
    "type": "object"
  },
  "type": "record"
}
multiObservationEntry object

A single result within a composite observation, fully self-describing.

Properties

observedProperty string at-uri Required

AT-URI of the dev.sensorthings.observedProperty record

resultQuality string Optional

Quality flag for this specific entry, if different from the composite quality

maxLength: 64 bytes
Known values: dev.sensorthings.quality#good, dev.sensorthings.quality#suspect, dev.sensorthings.quality#missing
resultScaleFactor integer Optional

Scale factor for this entry's numeric result. Default 0.

View raw schema 
{
  "description": "A single result within a composite observation, fully self-describing.",
  "properties": {
    "observedProperty": {
      "description": "AT-URI of the dev.sensorthings.observedProperty record",
      "format": "at-uri",
      "type": "string"
    },
    "result": {
      "refs": [
        "dev.sensorthings.observation#numericResult",
        "dev.sensorthings.observation#categoryResult",
        "dev.sensorthings.observation#booleanResult",
        "dev.sensorthings.observation#arrayResult",
        "dev.sensorthings.observation#geoPointResult"
      ],
      "type": "union"
    },
    "resultQuality": {
      "description": "Quality flag for this specific entry, if different from the composite quality",
      "knownValues": [
        "dev.sensorthings.quality#good",
        "dev.sensorthings.quality#suspect",
        "dev.sensorthings.quality#missing"
      ],
      "maxLength": 64,
      "type": "string"
    },
    "resultScaleFactor": {
      "description": "Scale factor for this entry's numeric result. Default 0.",
      "type": "integer"
    },
    "unitOfMeasurement": {
      "ref": "dev.sensorthings.datastream#unitOfMeasurement",
      "type": "ref"
    }
  },
  "required": [
    "observedProperty",
    "unitOfMeasurement",
    "result"
  ],
  "type": "object"
}

Lexicon Garden

@