The vector scatter layer is a data mapping layer in 3D City Builder. It supports independent configurations for styles and data, such as geometry, environment, icons, and background. This topic describes the configuration items for the vector scatter layer.
In the layer list on the left side of the scene editor, click the Vector Scatter Layer to open the configuration panel and configure the style and data of the Vector Scatter Layer.
If the Vector Scatter Layer is not in the layer list, it means you have not yet added a Vector Scatter Layer. To add one, 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
Parameter
Description
Blend mode
Set the blend mode for rendering the vector scatter layer. Options are Additive mode, Normal mode, and No Overlap mode.
Depth Write
Turn on the switch to enable depth write for the vector scatter layer. Turn off the switch to disable it.
NoteIf depth write is enabled, this object may occlude objects behind it.
Depth Test
Turn on the switch to enable depth test for the vector scatter layer. Turn off the switch to disable it.
NoteIf depth testing is enabled, an object will be occluded if it is located behind another object.
Height from Ground
Drag the slider to set the height of the vector scatter layer from the ground.
Geometry Rotation
Drag the sliders to set the rotation of the vector scatter layer on the x-axis, y-axis, and z-axis.
Geometry Scaling
Drag the sliders to set the scaling of the vector scatter layer on the x-axis, y-axis, and z-axis.
Graphics
Parameter
Description
Geometry Shape
Set the geometric shape style for the vector scatter layer.
Geometry Parameters
Drag the slider to set the radius of the vector scatter layer.
Geometry Display
Set the display method for the geometry of the vector scatter layer. Options are volume or line.
Geometry Color
Set the color of the geometry for the vector scatter layer.
Texture Map
Set the texture map style for the vector scatter layer.
Interaction
Parameter
Description
Mouse Interaction
Turn on the switch to enable mouse interaction for the vector scatter layer. Turn off the switch to disable it.
Click Color
Set the color of the icon when the vector scatter layer is clicked.
Opacity
Drag the slider to set the opacity of the vector scatter layer.
Click Scaling
Drag the slider to set the scaling ratio of the highlighted geometry relative to the clicked geometry.
Data panel
Parameter |
Description |
lng |
The longitude of the centroid of the vector scatter layer. |
lat |
The latitude of the centroid of the vector scatter layer. |
altitude |
The height of the centroid of the vector scatter layer. |
value |
The size of the geometry of the vector scatter layer. |
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
In the scenario editor, go to the layer list on the left side and click the
icon to the right of Vector Scatter Layer.Click the
icon in the upper-left corner of the page.On the blueprint editor page, click Vector Scatter Layer in the imported nodes bar. The 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 is returned and processed by the filter. The event also returns the processed data in JSON format. For a data example, see the Data Response Result area on the Data tab of the widget's configuration panel on the right of the canvas editor.
Rendering complete
An event that is triggered when the vector scatter layer is rendered. The event returns object data.
When left-clicked
An event that is triggered when you left-click the vector scatter layer. The event returns the mouse click coordinates and the raw data item.
Actions
Action
Description
Request Data API
Requests data from the server-side again. Data from an input data processing node or a layer node is used as a parameter. For example, if the API data source for the vector scatter layer is set to
https://api.testand the data passed to the Request Data API action is{ id: '1'}, the final requested API ishttps://api.test?id=1.Import Data API
Process the data to match the component's display format, then import and redraw the component. You do not need to request data from the server-side again. For data examples, see the Data Response area on the Data tab of the configuration panel, which is to the right of the component in the canvas editor.
Display Component
Shows the widget. No parameters are required.
Hide Widget
Hides the widget. No parameters are required.