# 3D 世界地图

# 属性

# 基础

组件标题： 用于在图层中显示组件的名称。1.1+
组件尺寸： 组件的宽度和高度，单位为px。
组件位置： 组件在大屏中的位置，通过横纵坐标来定义，单位为px。
旋转角度： 组件在大屏中旋转的角度。
透明度： 组件的透明度。
背景颜色： 组件的背景颜色。
图层管理： 对地图图层的管理。
- 三维柱状图层
  - 显示图层: 是否显示图层。
  - 图层名称: 图层名称。
  - 鼠标事件: 是否显示鼠标事件。
  - 柱状图形设置:
    - 柱型粗细: 柱型的粗细。
    - 倒角尺寸: 柱型的倒角尺寸。
    - 光滑度: 柱型的光滑度。
    - 最小高度: 柱型最小高度。
    - 柱型颜色: 柱型颜色。
    - 高亮颜色: 柱型高亮颜色。
  - 文本标签： 地图各国名称文本设置。
    - 显示文本： 是否显示文本。
    - 内容格式器： 标签内容格式器，支持字符串模板和回调函数两种形式，字符串模板与回调函数返回的字符串均支持用 \n 换行。
    字符串模板变量
    - {a} : 系列名。
    - {b} : 数据名。
    - {c} : 数据值。
    例如：
```
{b}: {c}
```
  回调函数
  
  可用参数为data。
  
  示例：
```
return data.name;
```
  参数 data是内容格式器需要的单个数据资源。格式如下：
```
{
  // 数据名，类目名
  "name": string,
  // 传入的原始数据项
  "data": Object,
  // 传入的数据值
  "value": number | Array,
  // 百分比
  "percent": number
}
```
  - 字体颜色： 文本的字体颜色。
  - 字体大小： 文本的字体大小。
  - 字体粗细： 文本的字体粗细。
  - 字体： 文本名称字体样式。
  - 边框宽度： 文本边框宽度。
  - 边框颜色： 文本边框颜色。
  - 背景颜色： 文本边框背景颜色。
- 高亮文本标签： 高亮文本的基础设置。
  - 显示文本： 是否显示高亮文本。
  - 内容格式器： 高亮文本的内容格式器与文本标签内容格式器配置一致。
  - 文字距离： 高亮文本间距离。
  - 字体颜色： 高亮文本的字体颜色。
  - 字体大小： 高亮文本的字体大小。
  - 字体粗细： 高亮文本的字体粗细。
  - 字体： 高亮文本名称字体样式。
  - 边框宽度： 高亮文本边框宽度。
  - 边框颜色： 高亮文本边框颜色。
  - 背景颜色： 高亮文本背景颜色。
- 视觉映射组件:
  - 显示映射： 是否显示映射。
  - 类型： 连续型/分段型
  - 最小值： 最小值。
  - 最大值： 最大值。
  - 视觉颜色： 柱状图图层视觉颜色。
  - 提示框： 与外层提示框设置相同。
  提示：
  
  外层提示框设置统一的字符串模板样式，如有需求内层提示框可单独设置字符串模板样式，内层提示框字符串模板样式高于外层示框字符串模板样式。
- 显示组件： 是否显示组件。
- 是否拖动： 是否开启拖动。
- 两端文本： 两端文本内容。
- 水平对齐：
  - 左
  - 中
  - 右
- 垂直对齐：
  - 上
  - 中
  - 下
- 字体颜色： 组件字体颜色。
- 字体大小： 组件字体大小。
- 字体粗细： 组件字体粗细。
- 字体： 组件字体样式。
- 三维散点层
  - 显示图层: 是否显示图层。
  - 图层名称: 图层名称。
  - 鼠标事件: 是否显示鼠标事件。
  - 散点设置：
    - 散点类型：
      - 圆形
      - 图钉
      - 箭头
      - 菱形
    - 散点大小： 散点大小。
    - 散点颜色： 散点颜色。
    - 高亮颜色： 高亮颜色。
- 视觉映射组件： 与 三维柱状图层 视觉映射组件功能配置相同。
- 提示框： 与图层外提示框功能相同。
提示：

外层提示框设置统一的字符串模板样式，如有需求内层提示框可单独设置字符串模板样式，内层提示框字符串模板样式高于外层示框字符串模板样式。
- 三维飞线层
  - 显示图层: 是否显示图层。
  - 图层名称: 图层名称。
  - 飞线设置： 飞线属性设置。
    - 飞线颜色： 飞线颜色。
    - 飞线宽度： 飞线宽度。
  - 飞线特效： 飞线特效设置。
    - 显示特效： 是否显示飞线特效。
    - 动画时间： 飞线特效动画时间。
    - 尾迹宽度： 飞线特效尾迹宽度。
    - 尾迹长度： 飞线特效尾迹长度。
    - 尾迹颜色： 飞线特效尾迹颜色。
  - 视觉映射组件： 与 三维柱状图层 视觉映射组件功能配置相同。
  - 提示框： 与图层外提示框功能相同。
  提示：
  
  外层提示框设置统一的字符串模板样式，如有需求内层提示框可单独设置字符串模板样式，内层提示框字符串模板样式高于外层示框字符串模板样式。

# 地理坐标系

地图宽度： 地图的宽度大小。
区域高度： 地图的高度。
地图高度： 图层的高度。
视线距离： 地图的的远近。
绕 x 轴： 地图绕 x 轴的旋转角度。
绕 y 轴： 地图绕 y 轴的旋转角度
距上边框： 地图距离上边框的距离。
距左边框： 地图距离左边框的距离。
着色效果： 地图的着色效果。
- 纯色
- 光照

地图区域样式： 地图各国地图区域设置。
- 区域颜色： 地图的颜色。
- 描边颜色： 各国描边的颜色。
- 描边宽度： 各国描边的宽度。
地图文本标签： 地图各省份名称文本设置。
- 显示文本： 是否显示文本。
- 字体颜色： 文本的字体颜色。
- 字体大小： 文本的字体大小。
- 字体粗细： 文本的字体粗细。
- 字体： 文本名称字体样式。
- 边框宽度： 文本的边框宽度。
- 边框颜色： 文本的边框颜色。
高亮地图区域样式： 地图各省份高亮地图区域设置。
- 区域颜色： 高亮区域的颜色。
- 描边颜色： 高亮区域描边的颜色。
- 描边宽度： 高亮区域描边的宽度。
地图高亮文本标签： 高亮文本的基础设置。
- 显示文本： 是否显示高亮文本。
- 字体颜色： 高亮文本的字体颜色。
- 字体大小： 高亮文本的字体大小。
- 字体粗细： 高亮文本的字体粗细。
- 字体： 高亮文本名称字体样式。
- 边框宽度： 高亮文本的边框宽度。
- 边框颜色： 高亮文本的边框颜色。
主光源效果： 设置主光源的投影效果，着色效果为光照时可选。
- 投影阴影： 是否显示投影阴影。
- 光源颜色： 主光源的颜色。
- 光源强度： 主光源的强度。
- 阴影质量： 阴影的质量。
  - 低
  - 中
  - 高
- 绕 x 轴： 主光源绕 x 轴的旋转角度。
- 绕 y 轴： 主光源绕 y 轴的旋转角度
环境光效果： 设置环境光的效果，着色效果为光照时可选。
- 环境光颜色： 环境光的颜色。
- 环境光强度： 环境光的强度。

# 标题

显示标题： 是否显示标题
内容：
- 标题
  - 主：主标题内容。
  - 副：副标题内容。
- 超链接
  - 主：主标题超链接。
  - 副：副标题超链接。
位置
- 水平对齐
- 垂直对齐
外观
- 内边距
- 主副间隔

主标题文本样式
- 字体颜色： 主标题字体颜色。
- 字体大小： 主标题字体大小。
- 字体粗细： 主标题字体粗细。
- 字体： 主标题字体样式。

副标题文本样式
- 字体颜色： 副标题字体颜色。
- 字体大小： 副标题字体大小。
- 字体粗细： 副标题字体粗细。
- 字体： 副标题字体样式。

# 图例

显示图例： 是否显示图例。
选中模式： 图例选择的模式，控制是否可以通过点击图例改变系列的显示状态。
内容格式器： 用来格式化图例文本，支持字符串模板和回调函数两种形式。
- 字符串模板： {name}
- 回调函数：
```
return data;
```
位置
- 排列方式： 图例列表的布局朝向。
- 水平位置： 水平排列。
- 垂直位置： 垂直排列。

文字样式
- 字体颜色： 图例字体颜色。
- 字体大小： 图例字体大小。
- 字体粗细： 图例字体粗细。
- 字体： 图例字体样式。

# 提示框

显示提示框： 是否显示提示框。
提示模板 ：提示框浮层内容格式器，支持字符串模板和回调函数两种形式。
- 字符串模板
  
  模板变量有 {a}, {b}，{c}，{d}，{e}，分别表示系列名，数据名，数据值等。在触发点为坐标轴的时候，会有多个系列的数据，此时可以通过 {a0}, {a1}, {a2} 这种后面加索引的方式表示系列的索引。不同图表类型下的 {a}，{b}，{c}，{d} 含义不一样。其中变量{a}, {b}, {c}, {d}在不同图表类型下代表数据含义为：
  - 折线（区域）图、柱状（条形）图、K 线图 : {a}（系列名称），{b}（类目值），{c}（数值）, {d}（无）
  - 散点图（气泡）图 : {a}（系列名称），{b}（数据名称），{c}（数值数组）, {d}（无）
  - 地图 : {a}（系列名称），{b}（区域名称），{c}（合并数值）, {d}（无）
  - 饼图、仪表盘、漏斗图: {a}（系列名称），{b}（数据项名称），{c}（数值）, {d}（百分比）
- 回调函数
```
"return data"
```

触发点：
- 坐标轴： 坐标轴触发，主要在柱状图，折线图等会使用类目轴的图表中使用。
- 数据项： 数据项图形触发，主要在散点图，饼图等无类目轴的图表中使用。

提示外观
- 背景颜色： 提示框浮层的背景颜色。
- 边框颜色： 提示框浮层的边框颜色。
- 边框宽度： 提示框浮层的边框宽度。
- 内边距： 提示框浮层内边距。

文本样式
- 字体颜色： 提示框字体颜色。
- 字体大小： 提示框字体大小。
- 字体粗细： 提示框字体粗细。
- 字体： 提示框字体样式。

# 工具栏

显示工具栏： 是否显示工具栏。
功能按钮
- 保存为图片按钮
- 还原按钮
- 数据视图按钮

位置朝向
- 排列方式： 功能按钮的布局朝向。
- 水平位置： 水平排列。
- 垂直位置： 垂直排列。

图表尺寸
- 图标大小
- 间隔

# 交互

# 标记单击事件

勾选启用，开启组件交互功能。当单击 3D 世界地图标记时，绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值，触发数据请求，查询相关数据，更新组件。具体配置请参考组件交互。

# 数据响应

3D 世界地图支持数据响应配置。

# 数据的上卷，下钻

3D 世界地图支持数据上卷，下钻配置。

提示：

标记单击事件，数据响应配置在各图层内配置。数据的上卷，下钻配置只有外层交互打开时，各图层数据的上卷，下钻才能启用。

# 节点编程

# 事件

图表配置转换完成后： 图表 Option 配置转换完成后事件。
- 抛出的参数： 配置完成后的 Option 。

# 动作

导入图表配置： 可导入 Echarts 图表 Option 配置。
- 接收的参数： 修改后的 Option 。

← 3D 省份地图 3D 地球 →