sensorthings is a plugin for the VC Map that makes it possible to display sensor locations and the corresponding data from the SensorThings API as a VectorTiles Layer.

Key Features

The plugin provides the following:

  • an new layer type called Sensorlayer to be added in App configurator as new layer

  • one layer per observation type (restriction)

  • advanced filter options by defining a filter query in JSON Editor

  • 4 different FeatureInfo types:

    • 2 FeatureInfo types with chart diagram

    • 2 FeatureInfo types for dashboard visualization

Sensorlayer

  • required URL to SensorThings API Service (without /Things or etc.) e.g. https://airquality-frost.k8s.ilt-dmz.iosb.fraunhofer.de/v1.1

  • Sensorlayer will start its query on /Things

  • after leaving the field, the URL will be checked and a notification of success or warning will appear

  • once the url check was successful, filter for observation type will be provided under "Advanced settings"

    • Advanced settings

      • Observed property filter

        • choose an observation type (populated by /ObservedProperty) to be displayed in the map

          • result will be all Things with choosen ObservedProperty

        • leaving the field blank will fetch all Things from server

      • Additional filters

        • allows to add simple or complex filter queries

        • examples:

          • $filter=description eq 'Bodenfeuchte' and properties/tenantUID eq '97609513-84AF-46BD-B6A6-76C071F1FBFB' and properties/deletedFlag eq 'False' and properties/activeFlag eq 'True'

          • $filter=Datastreams/Thing/Datastreams/ObservedProperty/name eq 'Temperature'

          • $filter=ObservedProperty/@iot.id eq 1

          • $filter=properties/type eq 'station' and properties/gewaesser.Location/name eq 'Rhein'

  • setting an extent for the layer will perform a spatial query against the server

    • using the default value will use the whole earth as extent

  • under "Handling in map" please choose the respective FeatureInfo related to that layer

  • under "Display" change the style if you prefer a custom one

    • if not, the default style defined by VCS will be used

    • styles can be:

      • VectorStyleItems

      • DeclarativeStyleItems using attributes to style sensor features

FeatureInfo

FeatureInfo types

The info type can be selected by the user and is either shown as a dashboard visualization or a diagram visualization.

Diagram FeatureInfo

  • choice to display FeatureInfo either as Balloon or separate FeatureInfo window

    • ChartFeatureInfoView

    • ChartBalloonFeatureInfo

  • selection of default days to request data from server

  • default option to overwrite title of FeatureInfo

    • also by using attributes / properties of feature e.g. {{Things/0/properties/sensordata/whatever}}

  • default option to define a new icon for FeatureInfo window using VCS icons or material design icons e.g. mdi-weather-windy-variant

Dashboard FeatureInfo

  • choice to display FeatureInfo either as Balloon or separate FeatureInfo window

    • DashboardFeatureInfoView

    • DashboardBalloonFeatureInfo

  • set the baseURL to:

  • option to set title of Dashboard

    • either as String, or

    • also by using attributes / properties of feature e.g. {{Things/0/properties/sensordata/whatever}}

  • default option to define a new icon for FeatureInfo window using VCS icons or material design icons e.g. mdi-weather-windy-variant

  • default option to overwrite the title of the FeatureInfo, e.g. Thing: {{properties/thingID}}

  • options to set width, height, max-width, max-height of the FeatureInfo window