SensorThings new section

docs/user_manual/introduction/browser.rst

@@ -303,41 +303,41 @@ each level of the dataset tree.
 Tiles and Web Services
 ......................
 
-+---------------+----------------------------------------------+--------------------------------------------------------------------------------------------------------------+
-| Level | Context menu | Type of services |
-| | +------------+-------------------+------------+------------+----------------+-------------+--------------------+
-| | | |wms| | |vectorTileLayer| | |xyz| | |wcs| | |wfs| | |afs| | |tiledSceneLayer| |
-| | | WMS / WMTS | Vector Tiles | XYZ Tiles | WCS | WFS / OGC | ArcGIS REST | Scene |
-| | | | | | | API - Features | Servers | |
-+===============+==============================================+============+===================+============+============+================+=============+====================+
-| Top menu | Create a :guilabel:`New Connection…` | |checkbox| | | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
-| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+
-| | Create a :guilabel:`New Generic Connection…` | | |checkbox| | | | | | |
-| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+
-| | Create a :guilabel:`New ArcGIS Vector Tile | | |checkbox| | | | | | |
-| | Service Connection…` | | | | | | | |
-| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+
-| | :guilabel:`Save Connections…` details | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
-| | to a file | | | | | | | |
-| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+
-| | :guilabel:`Load Connections…` | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
-+---------------+----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+
-| Connection | :guilabel:`Refresh` connection | |checkbox| | | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |
-| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+
-| | :guilabel:`Edit…` connection settings | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
-| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+
-| | :guilabel:`Delete` connection | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
-| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+
-| | :guilabel:`View Service Info` in Web browser | | | | | | |checkbox| | |
-+---------------+----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+
-| Table / Layer | :menuselection:`Export Layer --> To File...` | |checkbox| | | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |
-| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+
-| | :guilabel:`Add layer to Project` | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
-| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+
-| | Open :guilabel:`Layer properties…` dialog | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
-| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+
-| | :guilabel:`View Service Info` in Web browser | | | | | | |checkbox| | |
-+---------------+----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+
++---------------+----------------------------------------------+--------------------------------------------------------------------------------------------------------------+-------------------+
+| Level | Context menu | Type of services | |
+| | +------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
+| | | |wms| | |vectorTileLayer| | |xyz| | |wcs| | |wfs| | |afs| | |tiledSceneLayer| | |sensor| |
+| | | WMS / WMTS | Vector Tiles | XYZ Tiles | WCS | WFS / OGC | ArcGIS REST | Scene | SensorThings |
+| | | | | | | API - Features | Servers | | |
++===============+==============================================+============+===================+============+============+================+=============+====================+===================+
+| Top menu | Create a :guilabel:`New Connection…` | |checkbox| | | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
+| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
+| | Create a :guilabel:`New Generic Connection…` | | |checkbox| | | | | | | |
+| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
+| | Create a :guilabel:`New ArcGIS Vector Tile | | |checkbox| | | | | | | |
+| | Service Connection…` | | | | | | | | |
+| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
+| | :guilabel:`Save Connections…` details | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
+| | to a file | | | | | | | | |
+| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
+| | :guilabel:`Load Connections…` | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
++---------------+----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
+| Connection | :guilabel:`Refresh` connection | |checkbox| | | |checkbox| | |checkbox| | |checkbox| | |checkbox| | | |
+| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
+| | :guilabel:`Edit…` connection settings | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
+| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
+| | :guilabel:`Delete` connection | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
+| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
+| | :guilabel:`View Service Info` in Web browser | | | | | | |checkbox| | | |
++---------------+----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
+| Table / Layer | :menuselection:`Export Layer --> To File...` | |checkbox| | | |checkbox| | |checkbox| | |checkbox| | |checkbox| | | |checkbox| |
+| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
+| | :guilabel:`Add layer to Project` | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
+| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
+| | Open :guilabel:`Layer properties…` dialog | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| | |checkbox| |
+| +----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
+| | :guilabel:`View Service Info` in Web browser | | | | | | |checkbox| | | |
++---------------+----------------------------------------------+------------+-------------------+------------+------------+----------------+-------------+--------------------+-------------------+
 
 
 
@@ -438,6 +438,8 @@ Resources
  :width: 1.5em
 .. |postgis| image:: /static/common/mIconPostgis.png
  :width: 1.5em
+.. |sensor| image:: /static/common/sensor.png
+ :width: 1.5em
 .. |spatialite| image:: /static/common/mIconSpatialite.png
  :width: 1.5em
 .. |tiledSceneLayer| image:: /static/common/mIconTiledSceneLayer.png

docs/user_manual/managing_data_source/opening_data.rst

@@ -1618,6 +1618,62 @@ to your map.
  3D Tiles Layer - Textured
 
 
+.. index:: SensorThings
+.. _Sensor_things:
+
+Using SensorThings
+------------------
+
+Use the |addSensorThingsLayer| :guilabel:`SensorThings` tab in the :guilabel:`Data Source Manager` dialog
+or use the contextual menu of the :guilabel:`SensorThings` entry in the :guilabel:`Browser` panel to add
+a new SensorThings connection.
+
+To add a new service, press :guilabel:`New` (or :guilabel:`New SensorThings Connection`
+from the Browser panel) and provide the following:
+
+.. figure:: img/sensorThings_connection.png
+ :align: center
+
+ SensorThings Connection dialog
+
+* a :guilabel:`Name`
+* the :guilabel:`URL`
+* the :ref:`authentication <authentication_index>` configuration if necessary
+* a :guilabel:`Referer`
+* a :guilabel:`Entity Type`
+* a :guilabel:`Geometry Type`
+* a :guilabel:`Page Size`
+* a :guilabel:`Feature Limit` sets a maximum number of features to request from the service
+* a :guilabel:`Extent Limit` sets a maximum extent limit for the layer, so that only features
+ within the extent are requested
+* a :guilabel:`Filter` where you can build a query to filter the data, using SensorThings filter syntax.
+
+Press :guilabel:`OK` to establish the connection.
+Then you will be able to:
+
+* :guilabel:`Add` the new layer to the project; it is loaded with the name given in the settings.
+* :guilabel:`Edit` the SensorThings connection settings
+* :guilabel:`Remove` the connection
+* From the :guilabel:`Browser` panel, right-click over the entry
+ and you can also:
+
+ * :menuselection:`Export layer... --> To File`, :ref:`saving it as a vector
+ <general_saveas>`
+ * :guilabel:`Add layer to project`: a double-click also adds the layer
+ * View the :guilabel:`Layer Properties...` and get access to metadata and
+ a preview of the data provided by the service.
+ More settings are available when the layer has been loaded into the project.
+
+Configurations can be saved to an :file:`.XML` file (:guilabel:`Save Connections`)
+through the :guilabel:`SensorThings` entry in :guilabel:`Data Source Manager` dialog
+or its contextual menu in the :guilabel:`Browser` panel.
+Likewise, configurations can be added from a file (:guilabel:`Load Connections`).
+
+Through the Layer Source Properties dialog, you can set the :guilabel:`Page Size`,
+:guilabel:`Entity Type`, :guilabel:`Geometry Type`, :guilabel:`Extent Limit`, and :guilabel:`Feature Limit`
+for the existing layer in the project without having to add a new layer.
+
+
 .. Substitutions definitions - AVOID EDITING PAST THIS LINE
  This will be automatically updated by the find_set_subst.py script.
  If you need to create a new substitution manually,
@@ -1646,6 +1702,8 @@ to your map.
  :width: 1.5em
 .. |addSpatiaLiteLayer| image:: /static/common/mActionAddSpatiaLiteLayer.png
  :width: 1.5em
+.. |addSensorThingsLayer| image:: /static/common/mActionAddSensorThingsLayer.png
+ :width: 1.5em
 .. |addTiledSceneLayer| image:: /static/common/mActionAddTiledSceneLayer.png
  :width: 1.5em
 .. |addVectorTileLayer| image:: /static/common/mActionAddVectorTileLayer.png

substitutions.txt

@@ -1100,6 +1100,8 @@
  :width: 1.5em
 .. |sensor| image:: /static/common/sensor.png
  :width: 1.5em
+.. |addSensorThingsLayer| image:: /static/common/mActionAddSensorThingsLayer.png
+ :width: 1.5em
 .. |setProjection| image:: /static/common/mActionSetProjection.png
  :width: 1.5em
 .. |setToCanvasExtent| image:: /static/common/mActionSetToCanvasExtent.png