The OD flying routes layer in 3D City Builder displays origin-destination (OD) data between two geographical points as flying routes. You can configure the style and data for this layer independently. These routes can represent relationships between two locations, such as logistics or transaction flows. This topic describes the configuration items for the OD flying routes layer.
In the layer list on the left side of the scene editor, click the OD Flight Line layer to open the configuration panel. In the panel, you can configure the style and data for the OD Flight Line layer.
If the layer list does not contain OD Fly Line, you need to add the OD Fly Line layer. 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.
OD flying routes layer configuration panel:
General: Contains the general configuration parameters.
Parameter
Description
Mixed mode
Sets the blend rendering mode for the OD flying routes layer. Options are Additive mode, Normal mode, and No overlay mode.
Attenuation by distance
If enabled, the screen space width of the flying route decreases as the distance from the camera increases. If disabled, the screen space width remains constant.
Route segments
A flying route consists of many straight line segments. Drag the slider to adjust the number of segments. A higher value makes the route smoother but increases performance overhead. The value range is 1 to 300.
Edge blur
Adjusts the anti-aliasing effect on the route's edges. A higher value provides better anti-aliasing but makes the route appear visually thinner. Drag the slider to set the edge blur ratio. The value range is 0 to 1.
Graphics: Contains the graphics configuration parameters.
Parameter
Description
Route curvature
Drag the slider to set the sag-to-span ratio for the route's curvature. The value range is 0 to 10.
Route line type
Sets the style of the route line. Options are Vector and Texture.
Baseline
Sets the baseline style.
Baseline thickness: Drag the slider to adjust the baseline thickness. The value range is 0 to 500.
Baseline color: Sets the baseline color.
Opacity coefficient: Drag the slider to adjust the baseline opacity. The value range is 0 to 1.
Highlight line
Sets the highlight line style. This appears only when Route line type is set to Vector.
Highlight count: Drag the slider to adjust the number of highlight lines. The value range is 1 to 30.
Highlight thickness: Drag the slider to adjust the highlight line thickness. The value range is 0 to 200.
Dashed line length: Drag the slider to adjust the length of the dashed lines. The value range is 0 to 1.
Highlight color: Sets the highlight line color.
Opacity coefficient: Drag the slider to adjust the highlight line opacity. The value range is 0 to 1.
Fly Line Map
Sets the route texture style. This appears only when Route line type is set to Texture.
Flying route: When the texture type is Default, set the default texture type for the route and the tiling values in the u and v directions. When the texture type is Custom, set the URL for the custom route texture and the tiling values in the u and v directions.
Symbol texture: When the texture type is Default, set the default symbol texture type for the route and the symbol spacing between textures. When the texture type is Custom, set the URL for the custom route texture and the symbol spacing between textures.
Animation: Contains the animation configuration parameters.
Parameter
Description
Fly-line Speed
Drag the slider to adjust the route's movement speed. The value range is -0.2 to 0.2. The sign of the number (positive or negative) indicates the direction of movement.
Symbol speed
Drag the slider to adjust the route's symbol speed. The value range is -0.04 to 0.04. The sign of the number (positive or negative) indicates the direction of symbol movement.
Data panel
Field |
Description |
geometry |
This section describes the fly-line coordinates. |
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, click the
icon next to the OD Flow layer.Click the
icon in the upper-left corner of the page.On the Blueprint Editor page, click the OD flying routes layer in the Import Nodes section. The configuration parameters for the OD flying routes layer are displayed on the canvas, as shown in the following figure.
Events
Event
Description
When a data API request is complete
This event is triggered after a data API request is returned and processed by the filter. The processed data is also returned in JSON format. For a data example, see the Data response area on the Data tab in the widget's configuration panel on the right of the canvas editor.
Actions
Action
Description
Request data API
Requests data from the server. Data from upstream data processing nodes or layer nodes is passed as parameters. For example, if an OD polyline is configured with the API data source
https://api.test, and the data{ id: '1'}is passed to the Request data API action, the final API request ishttps://api.test?id=1.Import data API
Processes data into the component's rendering format, imports the data into the component, and then re-renders the component. This action does not request new data from the server. For data examples, see the Data Response area on the Data tab in the configuration panel 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 next to the OD Flow layer.
icon in the upper-left corner of the page.