The Web Map Service (WMS) raster tile is a global layer in 3D City Builder. It supports independent configurations for style and data. These configurations include general, graphic, and interaction settings. This topic describes the configuration items for the WMS raster tile layer.
In the layer list on the left side of the scene editor, click the WMS Raster Tile layer. In the configuration panel, you can configure the style and data for the WMS Raster Tile layer.
This widget is available only to DataV Premium Edition users. To use this widget, you must upgrade to the Premium Edition.
If the layer list does not contain the WMS Raster Tile layer, it means the WMS Raster Tile layer has not been added. To add the layer, 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
Rendering order
Sets the rendering order of the WMS raster tile. A larger value brings the tile to the front.
Graphic
Parameter
Description
Transparency
Drag the slider to set the opacity coefficient for the WMS raster tile. The value ranges from 0 to 1.
HSB adjustment
Sets the HSB values for the WMS raster tile, including Hue, Saturation, and Brightness.
Interaction
Parameter
Description
Server-side interaction
Turn on this switch to let the WMS raster tile return query results for a clicked location. If this switch is off, the layer cannot return query results.
Data panel
Parameter |
Description |
url |
The service endpoint of the WMS raster tile. |
projType |
The projection type of the WMS raster tile. |
sublayers |
The layer name of the WMS raster tile. |
imageFormat |
The format of the WMS raster tile. |
verison |
The version of the WMS raster tile. |
featurelnfoFormat |
The query format of the WMS raster tile. |
headers |
The request headers for the WMS raster tile. |
customParameters |
The service parameters for the WMS raster tile. |
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 layer list on the left side of the Scene Editor page, click the
icon next to the WMS Raster Tile layer.Click the
icon in the upper-left corner of the page.On the blueprint editor page, click the WMS raster tile layer in the Import Nodes pane. The configuration parameters for the layer 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 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 area on the Data tab of the widget's configuration panel in the canvas editor.
On left-click
An event that is triggered when you left-click the WMS raster tile. The returned data is of the object type.
Actions
Action
Description
Request data API
Re-requests server-side data. Data from input data processing nodes or layer nodes is used as parameters. For example, if a WMS raster tile has an API data source of
https://api.testand the data passed to the Request data API action is{ id: '1'}, the final request URL ishttps://api.test?id=1.Import data API
Processes data based on the component's drawing format, and then imports the data to redraw the component. This action does not re-request server-side data. For a data example, see the Data Response Result area on the Data tab of the component's configuration panel in the canvas editor.
Show component
Shows the component. No parameters are required.
Hide component
Hides the component. No parameters are required.
icon next to the WMS Raster Tile layer.
icon in the upper-left corner of the page.