Connection

Datasource Public ID

The Datasource Public ID functions as a unique identifier for datasources, facilitating the identification and interaction with specific map layers by external systems. The public ID is utilized, for example, in the postmessage API. When external systems embed the HxGN Smart Sites client application, they specify the publicId within the datasourceId field of the postmessage API messages, indicating the intended datasource for the communication.

Datasource Title

The Datasource Title is the name used to identify the datasource for end-users.

Datasource Description

The Datasource Description is the optional text used to describe the datasource for end-users.

Datasource Protocol

The Datasource Protocol defines how the HxGN Smart Sites will interpret the Datasource URL to establish the connection. The Datasource Protocol unlocks protocol-specific capabilities.

HxGN Smart Sites relies on OGC services to connect to the datasource.

The supported protocols are:

• WFS, for vector data services
• WMS, for raster data services
• HSPC, for HxGN Smart Point Clouds
• OGC 3D Tiles, for 3D models
• LTS, Luciad Tile Service
• Tianditu
• Google 3D Tiles

Datasource URL

The Datasource URL is used to connect to the underlying service.

Datasource Options

Data source connections might require protocol-specific options:

WMS: Layers

WMS Layers define which layers, published by the underlying WMS service, will be used. One or more layers can be configured. Ensure that the values align with the names of the layers revealed in the GetCapabilities operation of the underlying WMS service.

WFS: Feature Type

The Feature Type configures which vector object will be visualised when connecting to a WFS datasource.

WFS: Realtime Channel ID

The Channel ID indicates that the datasource supports realtime data. The Channel ID refers to the ActiveMQ topic and the WebSocket channel where the realtime data is emitted.

The Channel ID unlocks the realtime capability of the HxGN Smart Sites client. Where users toggle the "Realtime Mode", the HxGN Smart Sites client will start listening for incoming realtime events for display.

note

The Fusion Server installed with HxGN Smart Sites listens to ActiveMQ topics and pushes the data to the corresponding WebSocket channels.

LTS: Coverage ID

The Coverage ID identifies the coverage that is published by the underlying LTS service.

Tianditu: Layer

The layer used in the Tianditu map service.

The input options map to the actual Tianditu layer are as follows:

Option	Tianditu layer
Rasterized vector data	vec
Background imagery	img
Labels	cva