The Single Point Column Layer is a layer in the 3D city builder that displays point data as columns in 3D space. This layer supports independent style and data configurations, such as the top and bottom radius, number of sides, and colors for minimum and maximum values. This topic describes the configuration items for the Single Point Column Layer.
In the layer list on the left side of the scene editor, click the Single Point Columnar Layer to open the configuration panel, where you can configure the style and data of the Single Point Columnar Layer.
If the layer list is missing the Single Point Column Layer, the Single Point Column Layer has not been added. For more information, see Add a sub-widget.
Style panel
-
Search Configuration: To quickly find a specific configuration item, click on the Configuration panel in the upper right corner and enter the item's name in the Search Configuration field. The system utilizes a fuzzy match to assist in locating items. For more information, see search configuration items.
General: The general configuration parameters.
Parameter
Description
Mixed mode
Sets the material blending mode for the columns. Options: Additive mode, Normal mode, and No blending mode.
Depth write
Enables or disables depth write.
NoteIf depth write is enabled, the object may block objects behind it.
Depth test
Enables or disables depth test.
NoteIf depth test is enabled, the object may be blocked by objects behind it.
Directional light influence
Specifies whether the columns are affected by directional light. Enabling this option enhances the 3D effect but increases performance overhead. Disable this option when you have many columns.
Bottom elevation
Drag the slider to set the height of the column bottoms from the ground plane. The value ranges from 0 to 500,000 m.
Height scaling ratio
Drag the slider to set the overall height scaling ratio for all columns in the layer. The value ranges from 0 to 100,000.
Graphics: The graphics parameters.
Parameter
Description
Number of sides
Drag the slider to set the number of sides for the columns. The value ranges from 3 to 30.
Top radius
Drag the slider to set the radius of the column tops. The value ranges from 0 to 50,000.
Bottom radius
Drag the slider to set the radius of the column bottoms. The value ranges from 0 to 50,000.
Column color
The color configuration for the columns. For more information, see Color Mapper Guide.
Animation: The animation parameters.
Parameter
Description
Animation switch
Enable or disable an animation of a glowing band that loops from bottom to top on the side of the columns.
Animation parameters
Configure the following parameters when animation is enabled.
Glowing band length ratio: Drag the slider to set the length ratio of the glowing band. The value ranges from 0 to 1.
Animation speed: Drag the slider to set the animation speed. The value ranges from 0 to 0.2.
Glowing band brightness: Drag the slider to set the brightness of the glowing band. The value ranges from 0 to 1.
Glowing band color: The color configuration for the glowing band. For more information, see Color picker.
Data panel
Field |
Description |
lng |
The longitude of the layer's centroid. |
lat |
The latitude of the layer's centroid. |
value |
The value of the layer's centroid. |
Configuration Item |
Description |
Controlled Mode |
Turn on the switch to prevent the widget from requesting data upon initialization. Data is requested only through a callback ID or a method configured in the blueprint editor. Turn off the switch to allow automatic data update requests. The switch is off by default. |
Automatic Update Request |
Select this option to enable dynamic polling and manually set the polling frequency. If you clear this option, data is not updated automatically. You must manually refresh the page or trigger data update requests using the blueprint editor or callback ID events. |
Data Source |
Click Configure Data Source. In the Set Data Source panel, you can modify the data source type and data query code, preview the data source return results, and view the data response. |
Data Result |
Displays the response result of a data request. When the data source changes, click the |
icon on the right to view the real-time data response.You can also use the layer data API as a block data API to configure more data source types in the data dashboard or to interact with data from common chart widgets. For more information, see One-click generation of block APIs.
If you created your 3D City Builder project in Spatial Data Project mode and the project contains data primitive layer content, you can use the Spatial Build Data Source to obtain spatial map data when you configure the data panel in the scene editor. The steps are as follows:
In the layer configuration panel, select the Data tab. Click the Data Source Type drop-down list at the bottom of the panel and select Spatial Build Data Source.
From the Data Project drop-down list at the bottom of the panel, select an existing data project from the spatial build platform.
After you select a data project, select a matching dataset from the Dataset drop-down list.
NoteIf no configurable data types are available for the Data Project and Dataset configuration items, click Go to Spatial Build Platform to Manage Data in the panel to configure data in the spatial build platform. For more information, see Overview of spatial data management.
Blueprint interaction
On the current scene editor page, click the
icon to the right of Single Point Column Layer in the layer list on the left.Click the
icon in the upper-left corner of the page.On the blueprint editor configuration page, click the Single Point Column Layer layer in the import nodes bar. The blueprint editor configuration parameters for the layer appear on the canvas, as shown in the following figure.
Events
Event
Description
When data API request is complete
An event that is triggered after the data API request returns a response and the response is processed by a filter. The event also returns the processed data in JSON format. For a data example, see the Data response section on the Data tab of the widget's configuration panel in the canvas editor.
Rendering complete
An event that is triggered when the layer finishes rendering. The event returns data in an object format.
Actions
Action
Description
Call data API
Sends a new request for server-side data. Data from input data processing nodes or layer nodes is used as parameters. For example, if a single-point column layer is configured with an API data source of
https://api.test, and the data passed to the Call data API action is{ id: '1'}, the final API request is sent tohttps://api.test?id=1.Import data
After the data is processed in the format required for component rendering, import the data to the component to redraw it. You do not need to request data from the server again. For data examples, see the Data Response area on the Data tab in the configuration panel on the right side of the component in the canvas editor.
Show component
Shows the component. No parameters are required.
Hide component
Hides the component. No parameters are required.
icon to the right of Single Point Column Layer in the layer list on the left.
icon in the upper-left corner of the page.