3D globe

Updated at:

A map container is a container used to host the map itself and its sub-components in a 3D flat world map. You can add sub-components such as the scatter layer, flying line layer, and bar chart layer, configure the location and color of the map, and render real-time data of global geographic locations in 3D, multi-angle, and multi-format. This article describes the meaning of each configuration items of a 3D flat world map container.

Parameter

  • Manage sub-components
    • Add a component.
      1. In the console, click the 3D Flat World Map widget to go to the Configure tab on the right.
      2. Click the Add icon on the left of Components.
      3. Select one or more components and click Add Component. After the component is added, the component appears on the Manage Components page. Add a 3D flat world map subcomponent
      4. Click an added component and configure its parameters.
      5. After the configuration is complete, click the Back icon icon in the upper-left corner to return to the 3D Flat World Map configuration panel and configure other sub-components.
    • Copy, edit, or delete a component: Move the pointer over the component and click the Copy icon to copy the component. Click the Edit icon icon to edit the component. Click the Delete icon icon to delete the component.
  • Search for Configurations: In the right-side panel of Canvas Editor, click the Settings tab, and click Search for Configurations in the upper-right corner. Enter the required configuration item in the search box, and click the search icon to quickly locate the configuration item. Fuzzy match is supported. For more information, see Search for Configurations.
  • Size: indicates the size of a widget, including its pixel width and height. You can click the Proportional resizing icon to proportionally adjust the width and height of a widget. After you click this icon again, you can adjust the width and height as needed.
  • Position: the position of a widget, which is indicated by pixel X and Y coordinates. X-coordinate indicates the pixel distance between the upper-left corner of the widget and the left border of the canvas. Y-coordinate indicates the pixel distance between the upper-left corner of the widget and the upper border of the canvas.
  • Rotation Angle: the angle of a rotation that uses the center point of a widget as the rotation point. The unit is degrees (°). You can use one of the following methods to control the rotation angle of a widget:
    • Directly enter the degrees in the Rotation Angle spin box or click the plus sign (+) or minus sign (-) to increase or decrease the value in the Rotation Angle spin box.
    • Drag the black dot in the Rotation control icon icon.
    • Click the Horizontal flip icon to horizontally flip a widget.
    • Click the Vertical flip icon to vertically flip a widget.
  • Opacity: the opacity of a widget. Valid values: 0 and 1. If this parameter is set to 0, the widget is hidden. If this parameter is set to 1, the widget is completely displayed. Default value: 1.
  • Global SettingsGlobal settings
    • Camera rotation
      Parameter Feature
      Horizontal Direction The rotation angle of the camera in the horizontal direction. Valid values: -180 to 180.
      Vertical The rotation angle of the camera in the vertical direction. Valid values: -90 to 90.
    • Camera Center
      Parameter Feature
      Latitude The latitude of the camera center. Valid values: -90 to 90.
      Longitude The longitude of the camera center. Valid values: -180 to 180.
    • Camera Distance: the camera distance. Unit: pixels. Valid values: 18 to 420.
    • Map Interaction: If you turn on the switch, the map interaction feature is enabled. You can click events on the preview or publish page. Turn off the switch to disable the map interaction feature.
  • Fill SettingsFill Options
    • Fill Color
      Parameter Feature
      Minimum The color of the country corresponding to the minimum value. For more information, see color picker description.
      Max Value The color of the corresponding country area when the value of the data is the largest.
      Note Different countries/regions are rendered with different colors based on the value field in the data tab.
      No data The color of the country region when the value field for the corresponding country is not defined in the data panel.
      Back The colors on the back of the map and the colors you can see when you rotate to the back.
    • Edge Options
      Parameter Feature
      Color The color of the map edge.
      Width The width of the edge of the map. Unit: pixels.
      Transparency The transparency of the edge of the map. Valid values: 0 to 1.

The metadata of the filtering table.

The default data of the map container can be configured with two fields: id and value. Map Container Data PanelDownload the sample JSON code in the preceding figure.
Table 1. Description
Field Description
id The short name of the country on the map.
value The value corresponding to the country matches the maximum, minimum, and no data configuration items to determine the color of the area.
name Optional. The full name of the country.
Table 1. Parameters
Parameter Description
Controlled Mode If you turn on the switch, data is not requested when a widget is initialized. Data requests are triggered only based on callback IDs or the method configured in Blueprint Editor. If you turn off the switch, data requests are automatically triggered. By default, the switch is turned off.
Auto Data Request After you select the Auto Data Request check box, you can enable dynamic polling, and manually specify the polling interval. If you do not select this check box, data is not automatically requested. You must manually refresh the page to request data or use Blueprint Editor or callback ID events to trigger data requests.
Data Source In the right-side panel of Canvas Editor, click the Data tab. Click Set next to Static Data. In the Configure Datasource panel, select a data source from the Data Source Type drop-down list. Enter code for data query in the code editor, click Preview Data Response to preview the response of the data source, and then view the response. For more information, see Configure asset data.
Data Filter If you select the Data Filter check box, you can convert the data structure, filter data, and perform simple calculations. If you click the plus sign (+) next to Add Filter, you can configure the script for the data filter in the editor that appears. For more information, see Use the data filter.
Data Response Result The response to a data request. If the data source changes, you can click the Refresh icon icon next to Data Response Result to view the data response in real time.

Interaction

This widget does not support interaction events.

Configure interactions in Blueprint Editor

  1. In Canvas Editor, right-click a widget in the Layer panel and select Add to Blueprint Editor.
  2. Click the Blueprint Editor icon icon in the upper-left corner of the page.
  3. In the blueprint editor, click the 3D Flat World Map widget in the Added Nodes pane. On the canvas, you can configure the parameters for the 3D flat world map, as shown in the following figure.
    • Event

      When the heat value data interface request is completed: The event is thrown after the data interface request is returned and processed by the filter, and the JSON data is thrown at the same time. For more information, see Example data.

    • Policy Action
      Action Description
      Request Heat Value Interface This action is performed to request the server data again. The data sent by an upstream data processing node or layer node is used as a parameter. For example, if the API data source is http://api.test and the data passed to the Request Thermal Value Data Interface is { id: '1'}, the final request interface is http://api.test?id=1.
      Import heat value data After data of a widget is processed in accordance with its drawing format, the widget is imported for redrawing. You do not need to request server data again. For specific data, see Data.
      Update component configurations Style configurations of widgets are dynamically updated. Before this action is executed, you must click the widget in Canvas Editor, click the Settings tab in the right-side panel, and click Copy Configurations to... to obtain widget configurations. After that, change the style field for the data processing node in Blueprint Editor.
      Display A widget is shown without the need to specify parameters.
      Hide A widget is hidden without the need to specify parameters.
      Switch to the implicit state A widget is hidden or shown.
      Move A widget is moved to a specified location. Example:
          {
            // The positioning type. to indicates absolute positioning, whereas by indicates relative positioning. The default value is to. 
              "positionType": "to",
            // The location, which is indicated by the x and y coordinates. 
            "attr": {
              "x": 0,
              "y": 0
            },
            // The animation type. 
            "animation": {
              "enable": false,
              // The duration in which animation is displayed. 
              "animationDuration": 1000,
              // The animation curve, which can be set to linear|easeInOutQuad|easeInOutExpo. 
              "animationEasing": "linear"
            }
          }