Skip to main content

Site Settings

Site Settings allow configuration of the HxGN Smart Sites Client.

Coordinate references​

Select the coordinate references that should be available in HxGN Smart Sites Client. In HxGN Smart Sites Client, users can change the map references to any of the chosen references.

You must choose a default reference from the selected references by clicking its associated checkbox. In HxGN Smart Sites Client, the map initializes with the default reference.

If you want to enable 3D in the HxGN Smart Sites Client, make sure to select EPSG:4978.

The list of references is pre-defined in HxGN Smart Sites. Additional references can be added to the coordinate_references table of the hssadmin database by your system administrator.

Area of interest (AOI)​

Enable this setting to configure a specific area of interest for your site. The HxGN Smart Sites Client application restricts the viewport to this designated area, the rotation fixed according the site’s Coordinate Reference System (CRS).

To configure the area of interest, specify the area using two opposite corners. The boundaries derived from these corners form the smallest possible rectangle encompassing the area. Ensure the area does not exceed the size of a hemisphere, as larger areas are not supported. Select the reference in which the coordinates of the left-bottom and top-right corners are expressed.

Users can disable the viewport and rotation limitations by selecting the "Area of Interest" button located in the bottom menu bar of the HxGN Smart Sites Client application. Note that these limitations are only applicable in 2D mode; limiting the viewport and rotation is not supported in 3D mode.

Services​

This section guides you in configuring the services necessary for Hexagon Smart Sites.

Routing​

The routing feature enables you to calculate and visualize the shortest route between a start point, and an end point based on distance. You can activate or deactivate the routing feature by using the toggle button. To set up the routing service, you must specify the endpoint URL of a routing service configured in LuciadFusion.

Create a routing service​

To create a routing service, you need a network of roads in one of the following formats: SHP, GeoJSON, or GeoPackage. The quality of this data directly impacts the routing results. Ensure that the roads:

  • intersect correctly.
  • Are segmented, meaning they are divided into distinct segments at intersections rather than forming a continuous line.

Transform this data into the GeoPackage format required by LuciadFusion using the HxGN Smart Sites Network Builder. You can find this application and its README file within your product files. Before using it for the first time, unzip the application and add the license to the lib folder. Run the batch or shell script to see the available command line arguments.

In LuciadFusion, add the resulting GeoPackage and use it to create a ROUTING Service.

info
  • The network builder can only convert one file at a time.
  • You can add only one GeoPackage to the LuciadFusion service.
  • Only one routing service can be active in the Admin Site Settings.

For routing to be enabled in the HxGN Smart Sites Client, ensure that routing is enabled both in the Site Settings and in the Datasource.

Annotations​

The annotation feature allows users to view, create, and edit annotations within the Hexagon Smart Sites Client. You can enable or disable this feature using the toggle button. To configure the annotations service, specify the endpoint URL of an OGC WFS service, and select the appropriate feature type from the dropdown. For detailed instructions on setting up a WFS service to store annotations in LuciadFusion, please refer to the how-to guide.

Trusted Origins​

The trusted origins configure the hosts that are trusted by HxGN Smart Sites, when the HxGN Smart Sites Client is embedded by an external host application. Only postMessage api messages that are sent by a trusted origin are handled by HxGN Smart Sites Client. Any messages that do not come from trusted origins are discarded.

To allow messages from all origins, set the URL for the trusted origin to *. Wildcards in the trusted origin URL are not supported.

Keycloak Sync​

The Keycloak Sync button enables you to reset the authorization rules in Keycloak. Upon activation, the HxGN Smart Sites Admin Server removes and recreates all the resources, policies, and permissions needed by HxGN Smart Sites in Keycloak.

warning
Any previous modifications made to these rules via the Keycloak admin web console are permanently lost.