Class: QgsSensorThingsUtils

class qgis.core.QgsSensorThingsUtils

Bases: sip.wrapper

Utility functions for working with OGC SensorThings API services.

Added in version 3.36:

Methods

availableGeometryTypes

Returns a list of available geometry types for the server at the specified uri and entity type.

combineFilters

Combines a set of SensorThings API filter operators.

displayString

Converts a Qgis.SensorThingsEntity type to a user-friendly translated string.

entitySetStringToEntity

Converts a string value corresponding to a SensorThings entity set to a Qgis.SensorThingsEntity type.

entityTypeHasGeometry

Returns True if the specified entity type can have geometry attached.

fieldsForEntityType

Returns the fields which correspond to a specified entity type.

filterForExtent

Returns a filter string which restricts results to those within the specified extent.

filterForWkbType

Returns a filter string which restricts results to those matching the specified entityType and wkbType.

geometryFieldForEntityType

Returns the geometry field for a specified entity type.

geometryTypeForEntity

Returns the geometry type for if the specified entity type.

stringToEntity

Converts a string value to a Qgis.SensorThingsEntity type.

availableGeometryTypes(uri: str, type: Qgis.SensorThingsEntity, feedback: QgsFeedback = None, authCfg: str = '') List[Qgis.GeometryType]

Returns a list of available geometry types for the server at the specified uri and entity type.

This method will block while network requests are made to the server.

Parameters:
Return type:

List[Qgis.GeometryType]

combineFilters(filters: Iterable[str]) str

Combines a set of SensorThings API filter operators.

See https://docs.ogc.org/is/18-088/18-088.html#requirement-request-data-filter

Added in version 3.38.

Parameters:

filters (Iterable[str])

Return type:

str

displayString(type: Qgis.SensorThingsEntity, plural: bool = False) str

Converts a Qgis.SensorThingsEntity type to a user-friendly translated string.

If plural is True then a plural string is returned (ie “Things” instead of “Thing”).

Parameters:
Return type:

str

entitySetStringToEntity(type: str) Qgis.SensorThingsEntity

Converts a string value corresponding to a SensorThings entity set to a Qgis.SensorThingsEntity type.

Returns Qgis.SensorThingsEntity.Invalid if the string could not be converted to a known entity set type.

Parameters:

type (str)

Return type:

Qgis.SensorThingsEntity

entityTypeHasGeometry(type: Qgis.SensorThingsEntity) bool

Returns True if the specified entity type can have geometry attached.

Parameters:

type (Qgis.SensorThingsEntity)

Return type:

bool

fieldsForEntityType(type: Qgis.SensorThingsEntity) QgsFields

Returns the fields which correspond to a specified entity type.

Parameters:

type (Qgis.SensorThingsEntity)

Return type:

QgsFields

filterForExtent(geometryField: str, extent: QgsRectangle) str

Returns a filter string which restricts results to those within the specified extent.

The extent should always be specified in EPSG:4326.

Added in version 3.38.

Parameters:
Return type:

str

filterForWkbType(entityType: Qgis.SensorThingsEntity, wkbType: Qgis.WkbType) str

Returns a filter string which restricts results to those matching the specified entityType and wkbType.

Parameters:
Return type:

str

geometryFieldForEntityType(type: Qgis.SensorThingsEntity) str

Returns the geometry field for a specified entity type.

Parameters:

type (Qgis.SensorThingsEntity)

Return type:

str

geometryTypeForEntity(type: Qgis.SensorThingsEntity) Qgis.GeometryType

Returns the geometry type for if the specified entity type.

If there are no restrictions on the geometry type an ntity can have Qgis.GeometryType.Unknown will be returned.

Added in version 3.38.

Parameters:

type (Qgis.SensorThingsEntity)

Return type:

Qgis.GeometryType

stringToEntity(type: str) Qgis.SensorThingsEntity

Converts a string value to a Qgis.SensorThingsEntity type.

Returns Qgis.SensorThingsEntity.Invalid if the string could not be converted to a known entity type.

Parameters:

type (str)

Return type:

Qgis.SensorThingsEntity