A radiating bubble is a layer in 3D City Builder that shows the coverage area of a point target, such as the service area for a mall or hospital. You can independently configure its style and data, including the color, scaling factor, rotation speed, brightness, and height offset. This topic describes the configuration items for radiating bubbles.
In the layer list on the left of the scene editor, click the Radial Bubble layer to configure the style and data for the Radial Bubble in the configuration panel.
If Radial Bubble is not in the layer list, the Radial Bubble layer has not been added. For instructions on how to add it, see Add Sub-widget.
Style pane
-
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.
The following sections describe the parameters on the configuration pane for the radiating bubble.
General
Parameter
Description
Mixed mode
The mixed overlay rendering mode for the radiating bubble layer. Options include Additive mode and Normal mode.
Depth write
Turn on this switch to enable depth write for the radiating bubble layer. Turn off this switch to disable it.
NoteIf depth write is enabled, this object may occlude objects behind it.
Depth test
Turn on this switch to enable depth test for the radiating bubble layer. Turn off this switch to disable it.
NoteIf depth test is enabled, this object may be occluded by objects behind it.
Scaling factor
The scaling factor of the radiating bubble. A larger value indicates a larger scan radius. Valid values: 0.1 to 1000.
Height offset
The offset of the radiating bubble area from the ground plane. Valid values: -1000 to 5000.
Graphics
Parameter
Description
Entity color
The color of the radiating bubble. For more information, see Color picker.
Opacity
The opacity coefficient of the bubble. Valid values: 0.1 to 1.
Highlight color
The color of the radiating bubble when it is highlighted. For more information, see Color picker.
Highlight ratio
Drag the slider to set the brightness ratio of the bubble. Valid values: 0.1 to 1.
Animation: Configure the animation effects for the radiating bubble layer.
Parameter
Description
Animation epoch
Drag the slider to set the animation epoch. Valid values: 0.5 to 10.
Data pane
Parameter |
Description |
lng |
The longitude of the centroid of the radiating bubble. |
lat |
The latitude of the centroid of the radiating bubble. |
altitude |
The height of the centroid of the radiating bubble. |
value |
The value of the scan radius of the centroid of the radiating bubble. |
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 scene editor, click the
icon to the right of Radial Bubble in the layer list.Click the
icon in the upper-left corner of the page.On the blueprint editor page, click the Radiating bubble layer in the import node bar. The configuration parameters for the radiating bubble appear on the canvas, as shown in the following figure.
Events
Event
Description
When a data API request is complete
This event is triggered after the data API request is returned and processed by the filter. The processed data in JSON format is also returned. For a data example, see the Data response area on the Data tab of the widget's configuration pane on the right of the canvas editor.
Rendering complete
This event is triggered when the radiating bubble is rendered. Data of the object type is also returned.
Actions
Action
Description
Request data API
Requests server-side data again. Output data from input data processing nodes or layer nodes is used as parameters. For example, if a radial bubble layer is configured with the API data source
https://api.testand the data passed to the Request data API action is{ id: '1'}, the final API request ishttps://api.test?id=1.Import data API
After the data is processed in the format required for component rendering, the data is imported to redraw the component. You do not need to request data from the server again. For a data example, see the Data Response area on the Data tab of the configuration panel to the right 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 Radial Bubble in the layer list.
icon in the upper-left corner of the page.