Defining Configuration Fields (KB-AP017)

Once data is successfully synchronized in the Admin Portal, it can be configured to optimize 3D visuals in vGIS AR.

To view or edit an object layer’s configuration, select it from the data sources list.

Layer Group: This allows you to group an object layer to a specific layer on the vGIS app. Organizing objects into Layers allows device users to enable, or disable, entire groups of objects from the vGIS app.

Object Type: In most instances, the vGIS system will identify objects automatically, and you will not be able to switch the object type. On occasion, however, the vGIS system may not be able to identify an object layer and it will need to be identified manually. There are five different types of objects: 3D Model, Area, Line, Point, and Unknown.

Header Field: Object headers are displayed when viewing an object through the vGIS 3D Environment. By default, objects will display their object ID when being viewed.

Sub-Header: The value set in the sub-header field will be the second line displayed in the call-out bubble and the infocard. This field uses dynamic values for its attributes. Use the sample data at the bottom of the page to select the relevant value field.

Split Model By: This splits the model into workpacks based on specific criteria like name, type or other attributes. Grouping layers as such will minimize the time it takes to configure. 

Color: You can assign color to any object layer by either making a selection from the color chart, manually entering in a color code (in hexadecimal, RGB, or HSL), or it can be selected from the 30 preset colors. It is recommended to set some transparency to colors for large objects (e.g., Areas). The recommended percentage of opacity is 20% to 30%

Default Depth/Elevation: This setting allows you to set a default depth or altitude to an object layer. Zero is considered to be ground level, with positive numbers being above ground (altitude), and negative numbers being underground (depth). You can also choose a unit of measurement by selecting it in the drop-down box adjacent to the Default Depth/Altitude value field.

Depth/Elevation Field: Some data sources may include object values for depth/altitude. To use these values, you will need to map your data to the vGIS account. Using the sample data at the bottom of the page, find the depth/altitude field and select it from the Depth/Altitude Field drop-down box. Next, select the unit of measurement that your data source uses.

External ID (Additional Details): allows you to cross-reference your vGIS data to an external database by assigning an external ID to the object in this field.

Subtype (Additional Details): in some instances, objects may have sub-types with configuration that differs from the parent node. You can define these specific attribute values for the child nodes using Subtype field drop-down box. Different sub-type values will appear as child nodes and can be configured separately from the parent node. By default all settings will be inherited from the parent node.

Elevation Type (Additional Details): occasionally, certain feature layers will require their elevation type to be different than the default root setting. There are three Elevation Type settings:

• Default - Allows the system to recognize if the data set is z-enabled or not. If z-enabled, the base for the elevation calculations will refer to the sea level and its corresponding vertical datum. If not, it will count as Surface offset.
• Surface offset - Refers to the selected digital surface as the base for the elevation calculations.
• Ignore z-value - Ignores z-values within the data set.

Exclude from processing Toggle: when enabled, the system will exclude layer from processing (ignore all objects in layer).

Click here to access an article with links to configuration steps by data type.

Have Questions? Feel free to Submit A Request to speak with a member of the vGIS Support Team.

Reviewed:  2025-02-04