色彩地图
数据大屏色彩地图：VRDemo 演示表、字段绑定、样式、市级地图、钻取联动与常见问题。
在 VeryReport 数据大屏设计器 中，色彩地图用行政区填色深浅表达度量大小与空间分布。适用角色：大屏设计人员、数据分析师。
大屏组件不直接写 SQL。请先在数据中心创建并发布数据集，再在设计器中选用。详见 新建数据集。 练习数据见本文第 6 章示例。
1. 概述
1.1 功能说明
将地理区域维度与色彩饱和度度量绑定后，按中国省级（或聚焦省份后的市级）边界填色：数值越大，颜色越接近「最大色」。
1.2 适用场景
- 各省销售额、活跃用户、库存等空间分布；
- 多指标切换对比（如销售额 / 利润 / 成本）；
- 省 → 市钻取分析；
- 点击区域联动同页柱图等组件。
1.3 入口与前提
| 项 | 说明 |
|---|---|
| 设计器入口 | 数据分析 → 数据大屏 → 新建或打开大屏 |
| 组件路径 | 顶部 图表 → 地图 → 色彩地图 |
| 数据前提 | 需先在 数据中心 → 数据集 中创建并发布数据集 |
数据集创建步骤见：新建数据集。
2. 基础操作
2.1 插入色彩地图
- 打开大屏设计器。
- 顶部工具栏点击 图表 → 分组 地图 → 色彩地图。
- 画布出现中国省级底图。
- 未绑定数据集时仅显示空白底图（无色块、无色阶），属正常状态。
- 组件不可拖出画布边界。
2.2 选择数据集
- 在画布上 单击选中 色彩地图。
- 右侧出现两个面板：左侧为组件设置（字段 / 样式 / 事件），右侧为 数据。
- 在 数据 面板顶部点击 选择数据集，选择已发布的数据集。
- 选择成功后，数据面板列出 维度 与 度量 字段，可拖拽到左侧「字段」区。
若列表为空：请到数据中心确认数据集已 发布。
2.3 绑定字段
- 组件设置切换到 字段 Tab。
- 从右侧 数据 面板拖拽字段：
| 放置区 | 要求 | 说明 |
|---|---|---|
| 地理区域/维度 | 最多 1 个 | 文本型区域名，如省名、市名 |
| 色彩饱和度/度量 | 1～5 个 | 数值型指标；可设置聚合（默认多为求和） |
- 多个度量时，可在字段区、样式区或画布右上角切换「当前着色指标」。
- 底部可点击 更新 刷新；完成后 保存 或 保存并发布 大屏。
2.4 预期效果
- 有数据的区域出现色块；色阶图例显示当前度量最小～最大值。
- 「广东」与「广东省」等短名/全名均可匹配上色。
- 切换着色指标后，色块与色阶随之变化。
- 悬停区域：提示框显示名称与度量值；无数据区域显示为
-。
3. 样式配置
选中色彩地图 → 组件设置 → 样式 Tab。
3.1 地图区域
| 配置项 | 说明 |
|---|---|
| 显示范围 | 中国·省级 / 中国·市级 |
| 聚焦省份 | 仅「中国·市级」时出现，必选 |
| 边框色 / 边框宽 / 空区域色 | 轮廓与无数据区域底色 |
| 漫游 | 是否允许拖拽、缩放 |
| 中心经纬度 / 缩放 | 手动设定视角 |
3.2 色彩映射
| 配置项 | 说明 |
|---|---|
| 最小色 / 最大色 | 色阶两端颜色 |
| 透明度 | 区块填色透明度 |
| 映射区间 | 自动 或 自定义 最小/最大 |
3.3 最值配色
启用后可为 最大值 / 最小值 / 前三 / 后三 单独指定颜色（覆盖普通色阶）。
3.4 数据标签
| 配置项 | 说明 |
|---|---|
| 显示 | 是否显示标签 |
| 内容 | 区域名称 / 度量值 / 名称+度量 |
| 全量显示 | 开=全部区域标名；关=仅有数据区域并尽量防重叠 |
| 字号 / 颜色 | 标签样式 |
3.5 色阶图例、总计与提示框
| 模块 | 说明 |
|---|---|
| 色阶图例 | 显示开关、位置、字号与文字色 |
| 总计 | 当前着色度量汇总 |
| 提示框 | 悬停显示区域与度量值 |
4. 市级地图与钻取
4.1 仅查看某省地市
- 数据集需含地市名称字段；地理区域绑市名字段，度量绑数值字段。
- 样式 → 地图区域 → 显示范围 选 中国·市级，聚焦省份 选目标省。
- 无法匹配的地名会在右下角提示 N 条未匹配。
4.2 省 → 市钻取
适用于同一数据集中同时包含「省」「市」字段：先看各省汇总，点击某省再看该省地市。
4.2.1 配置数据（上层：省）
- 选中色彩地图，选择含省、市字段的数据集。
- 字段：地理区域拖入省字段；度量拖入数值字段。
- 显示范围保持 中国·省级，点击 更新。
4.2.2 配置钻取层级
- 事件 → 钻取，勾选 启用钻取。
- 添加 2 层（从粗到细）：层级1=省字段，层级2=市字段。
- 保存 大屏。
4.2.3 操作与回退
- 单击某个已上色的省 → 自动切市级并聚焦该省。
- 面包屑点 全部 回省级；点中间层级可回退。
- 再点市：已到最下层，不再继续钻取。
事件优先级：钻取 > 跳转 > 联动。
4.2.4 验收要点
| 检查项 | 预期 |
|---|---|
| 未点省 | 各省填色 |
| 点击某省 | 出现该省各地市色块 |
| 点「全部」 | 回到省级填色 |
5. 联动与跳转
入口：选中组件 → 事件 Tab。优先级：钻取 > 跳转 > 联动。测联动/跳转时请先关闭钻取，或钻到最下层后再点。
5.1 联动
5.1.1 配置步骤
- 同一页放置色彩地图与目标组件（如柱状图），尽量使用同一数据集。
- 选中地图 → 事件 → 联动：启用联动，填写触发字段（或点「用当前维度」），勾选目标图表。
- 保存 大屏。
5.1.2 操作说明
- 单击某区域 → 目标图仅保留该区域数据；无数据时显示「暂无数据」。
- 取消：再点同一区域，或点提示条 取消。
5.2 跳转
| 项 | 说明 |
|---|---|
| 触发字段 | 作为 URL 参数名 |
| 目标 | 外部 URL 或大屏 |
| 大屏 ID / URL | 按目标类型填写 |
| 打开方式 | 新窗口 / 当前 |
点击后：大屏打开 /screen/preview/{大屏ID}?{触发字段}={点击值}；外部 URL 追加查询参数。
5.3 事件优先级一览
| 已启用能力 | 点击可下钻时 | 已到最下层或不启用钻取 |
|---|---|---|
| 仅钻取 | 钻取 | 无动作（除非另配联动） |
| 钻取 + 跳转 | 钻取 | 跳转 |
| 钻取 + 联动 | 钻取 | 联动 |
| 跳转 + 联动（无钻取） | — | 跳转优先 |
| 仅联动 | — | 联动 |
6. 示例：VRDemo 练习数据
本章为可选练习示例，按步骤带你完成：创建数据集 → 省级填色 → 省→市钻取 → 地图联动柱图。生产环境请改用业务数据集，操作路径相同。
6.1 示例总览
| 示例 | 演示表 | 数据集建议命名 | 练习内容 |
|---|---|---|---|
| A. 省级填色 | map_province_sales | 省级销售 | 地理区域 + 多度量着色 |
| B. 省→市钻取 | map_city_sales | 地市销售 | 钻取层级、面包屑回退 |
| C. 联动柱图 | 同示例 B | 地市销售 | 地图点击过滤柱图 |
前提：数据源中已有 VRDemo。数据集界面说明见 新建数据集。
6.2 创建示例数据集
6.2.1 数据集一：省级销售（示例 A 用）
- 打开 数据中心 → 数据集，点击右上角 +。
- 左侧数据源切换为 VRDemo。
- 将表
map_province_sales拖到中间画布。 - 点击 完成，开始数据处理。
- 确认字段：
area（维度）、sales/profit/cost（度量）。 - 点击 保存并发布，名称可填：
省级销售。
6.2.2 数据集二：地市销售（示例 B、C 用）
- 再次 + 新建数据集。
- 数据源选 VRDemo，拖入
map_city_sales。 - 确认字段：
province（省）、area（市）、sales/profit（度量）。 - 保存并发布，名称可填：
地市销售。
两个数据集都需已发布，否则大屏选不到。
6.3 示例 A：省级填色（维度 / 度量怎么拖）
6.3.1 插入组件并选数据集
- 进入 数据分析 → 数据大屏，新建或打开大屏。
- 顶部 图表 → 地图 → 色彩地图。
- 选中色彩地图 → 右侧 数据 → 选择数据集
省级销售。
6.3.2 字段绑定（必做）
切换到 字段 Tab，从右侧数据面板拖拽：
| 放置区 | 拖入字段 | 聚合 | 说明 |
|---|---|---|---|
| 地理区域/维度 | area | — | 只能 1 个 |
| 色彩饱和度/度量 | sales | SUM（求和） | 主着色指标 |
| （可选）再拖入 | profit、cost | SUM | 多指标切换，最多共 5 个度量 |
- 先拖
area到「地理区域/维度」。 - 再拖
sales到「色彩饱和度/度量」，聚合选 求和。 - 可选继续拖
profit、cost；多度量时在「当前着色指标」选sales。 - 点击 更新 或 保存。
6.3.3 验收
| 操作 | 预期 |
|---|---|
| 查看地图 | 广东、江苏、浙江等出现色块 |
| 悬停「广东省」 | 提示框有销售额 |
切换到 profit | 色块随利润变化 |
| 悬停无数据省 | 显示 - |
6.4 示例 B：省 → 市钻取（含开启步骤）
使用数据集 地市销售。
6.4.1 绑定上层字段（按省汇总）
- 选中色彩地图 → 数据 选择
地市销售。 - 字段 Tab 绑定如下（上层用省字段，不要先拖市字段）：
| 放置区 | 拖入字段 | 说明 |
|---|---|---|
| 地理区域/维度 | province | 上层展示各省 |
| 色彩饱和度/度量 | sales（SUM） | 各省销售额 |
- 样式 → 地图区域 → 显示范围 保持 中国·省级。
- 点击 更新，确认各省有色块（演示数据主要覆盖广东、江苏、浙江）。
6.4.2 开启并配置钻取（详细步骤）
- 保持选中色彩地图 → 事件 Tab → 展开 钻取。
- 勾选 启用钻取。
- 点击 + 添加层级，配置两层（从粗到细）：
| 层级 | 填写内容 | 含义 |
|---|---|---|
| 层级1 | province | 与当前地理区域字段一致 |
| 层级2 | area | 点击省后下钻到市 |
- 若只有一层，再点一次 + 添加层级 补上第二层。
- 字段名须与数据集列名完全一致。
- 测钻取时建议先不要勾选联动/跳转（优先级：钻取 > 跳转 > 联动）。
- 点击工具栏 保存。
6.4.3 操作钻取与回退
- 单击地图「广东省」。
- 预期：自动切到中国·市级并聚焦广东；出现广州、深圳等市色块；面包屑
全部 / 广东省。 - 点面包屑 全部 → 回省级。
- 再点进省后点某个市 → 已到最下层，不再下钻。
- 「未知镇」可能在右下角出现未匹配提示。
6.4.4 钻取验收
| 步骤 | 预期 |
|---|---|
字段 province+sales，未点省 | 各省填色 |
| 点击「广东省」 | 面包屑含广东省；出现广州市、深圳市等 |
| 点「全部」 | 回到省级 |
层级写成 area→province | 异常或无数据（顺序必须省→市） |
6.5 示例 C：地图联动柱图（含开启步骤）
目标：点击地图某省后，同页柱状图只显示该省数据。
测联动时请先关闭钻取（取消勾选「启用钻取」），否则点击会优先钻取。
6.5.1 准备两个组件（同一数据集）
- 同一页放置 色彩地图 与 柱状图，都选择数据集
地市销售。
色彩地图字段：
| 放置区 | 字段 |
|---|---|
| 地理区域/维度 | province |
| 色彩饱和度/度量 | sales（SUM） |
柱状图字段：
| 放置区 | 字段 | 说明 |
|---|---|---|
| 类别轴/维度 | province | 必须与地图触发字段同名 |
| 值轴/度量 | sales（SUM） | 与地图度量一致便于对照 |
- 分别点 更新，确认地图有色块、柱图有柱。
6.5.2 开启联动（详细步骤）
- 只选中色彩地图（不要选中柱图）。
- 事件 Tab → 展开 联动。
- 勾选 启用联动。
- 触发字段：填写
province，或点 用当前维度。 - 目标图表：勾选同页的 柱状图。
- 确认 钻取 未启用。
- 保存 大屏。
6.5.3 操作与取消联动
- 单击「浙江省」→ 柱图只剩浙江；左上角可出现
已联动：浙江省与 取消。 - 单击无数据省（如内蒙古）→ 柱图显示 暂无数据（不应出现样例柱）。
- 取消：再点同一省，或点提示条 取消。
6.5.4 联动验收
| 步骤 | 预期 |
|---|---|
| 点「江苏省」 | 柱图仅江苏 |
| 再点「江苏省」 | 联动取消，柱图恢复 |
| 换点「广东省」 | 柱图变为广东 |
| 点无数据省 | 柱图「暂无数据」 |
| 钻取仍开启时点省 | 会钻取，不一定联动 |
6.6 示例字段速查
| 场景 | 数据集 | 地图地理区域 | 地图度量 | 事件 |
|---|---|---|---|---|
| A 省级填色 | 省级销售 | area | sales（可选 profit/cost） | 可不配 |
| B 省→市钻取 | 地市销售 | province | sales | 钻取：层级1=province，层级2=area |
| C 联动柱图 | 地市销售 | province | sales | 联动：触发=province，目标=柱图；柱图类别轴=province |
7. 常见问题
Q：地图全灰、没有色块？
A：检查是否已选中已发布数据集，并已拖入地理区域与度量。未绑定数据时底图为空属正常。
Q：选择数据集列表是空的？
A：数据集须在数据中心 发布 后才可选。参见 新建数据集。
Q：有数据但部分区域不上色？
A：核对区域名；点右下角未匹配角标查看原始值。
Q：市级地图加载失败？
A：确认聚焦省份有效；内网可放置本地 geo 文件。
Q：钻取后没有地市数据？
A：确认钻取两级字段名与数据集一致，且存在该省下级行。
Q：联动后目标图仍显示样例数据？
A：已绑定数据集且查询无数据时应显示「暂无数据」。
8. 相关文档
| 文档 | 说明 |
|---|---|
| 新建数据集 | 数据中心建模、保存与发布 |
| 数据集概述 | 数据集概念与用途 |
| 本文第 4～5 章 | 钻取、联动、跳转 |