区域热力层各配置项的含义是什么(v1.x版本)_DataV数据可视化-阿里云帮助中心

区域热力层是基础平面地图的子组件，支持独立的样式、数据和交互配置，包括区域的标注、颜色、边线、鼠标交互事件以及位置信息等，能够以热力区域的形式表现地理位置上的区域信息。本文介绍区域热力层各配置项的含义。

注意当前为v1.x版本的区域热力层子组件指导文档，如需查看该子组件v2.x版本的文档内容详情，请参见区域热力层（v2.x版本）。

单击子组件管理下方的区域热力层，进入配置面板配置区域热力层的样式和数据。

说明如果子组件管理中没有区域热力层，说明您还未添加区域热力层子组件，请参见地图容器（v1.x版本）进行添加。

配置

搜索配置：单击配置面板右上角的搜索配置，可在搜索配置面板中输入您需要搜索的配置项名称，快速定位到该配置项，系统支持模糊匹配。详情请参见搜索资产配置。
标注
- 标注字段：区域的标注字段，需要与地理数据中字段名称匹配。
- 颜色：标注的颜色，请参见颜色选择器说明进行修改。
- 阴影色：标注的阴影色。
- 字体：标注的字体系列。
  
  说明请选择系统中的字体，如果您的系统中没有所选的字体，标注会使用默认字体。
- 字号：标注文字的大小。
填充颜色：数据中最大、最小及为空的value值对应区域的颜色。
边线选项：区域热力层各区域边线的颜色、粗细和虚线线型。
交互配置
- 悬停：鼠标悬停区域的颜色，仅在预览或发布时可以看到效果。
- 显示弹窗：打开开关，显示弹窗信息；关闭开关，关闭弹窗信息。
- 点击聚焦：打开开关，启动点击聚焦功能。
- 聚焦范围比：所单击区域的聚焦范围。
- 回调 ID：设置组件之间数据联动的变量，需要配置为数据中的某一个字段。
  
  说明此功能已更新到交互面板中，配置面板的该功能将弃用，请尽快升级。新版本的交互功能支持配置多个字段。

数据

地理边界geojson数据接口：通过配置地理边界geojson数据接口，可将提取到的区域GeoJSON边界数据应用到DataV中，配置方法如下。
1. 数据提取。
  使用GeoJSON行政区划边界提取小工具DataV.GeoAtlas，最低可以提取区县级边界数据，区域adcode可以查阅省市区adcode与经纬度映射表，提取方法如下。
  - 省级：区域热力层默认显示为全国范围内，各个省和直辖市区域热力层数据，可以直接使用。
  - 地市级：以提取浙江省范围内所有地级市边界数据为例，提取方法如下图所示。
  - 区县级：以提取肇庆市范围内所有区县边界数据为例，提取方法如下图所示。
  - 乡镇街道及自定义区域：乡镇街道数据需要用户自己获取。根据需要自定义区域边界，如中国内地可以分为东部地区、西部地区、华南地区、华北地区、华中地区五大区，可以根据对应包含的省级边界数据合并得到。
2. 数据应用。
  将提取到的数据配置到DataV中，配置方法如下。
  1. 选择区域热力层 > 数据 > 地理边界geojson数据接口。
  2. 单击配置数据源，在设置数据源弹出框中，选择数据源类型为API。
  3. 将提取到的JSON API粘贴到数据输入区，如下图所示。
    上图中提取到了肇庆市包含子区域的边界信息，示例API如下。
```
https://geo.datav.aliyun.com/areas/bound/441200_full.json
```
  4. 发布大屏项目，可以看到配置的区域热力层。
在数据配置的过程中，可能会出现区域文字标注有偏移的问题，解决方法如下。
- 查看下您的区域热力层版本，目前可以使用的区域热力层组件包括区域热力层v0.2.4及以上版本。如果您使用的区域热力层版本较低，需要先删除该层，再重新添加。
- GeoJSON提取工具中的数据已更新，需使用新的GeoJSON数据文件。
- 修改参数。
  以肇庆市的区县级GeoJSON数据为例，高要区文字标注有偏移。
  1. 使用DataV.GeoAtlas边界生成器工具，上传肇庆市的区县级GeoJSON数据文件，在属性表面板中添加customLabelPosition属性参数。
    在属性表面板找到高要区的参数，编辑并新增一列customLabelPosition属性列，添加自定义"customLabelPosition": [112.500801,22.927694]属性。
    
    图 1. 修改属性
    
    图 2. 查看修改的属性
  2. 保存修改后，将GeoJson文件下载到本地，并将GeoJson文件上传到自己的服务器或者OSS上，生成一个新的API。
  3. 选择区域热力层 > 数据 > 地理边界geojson数据接口。
  4. 单击配置数据源，在设置数据源面板中选择数据源类型为API。
  5. 将修改后新生成的JSON API地址粘贴到数据输入区，设置完成后，高要区标注显示正常。

热力值数据接口

您可以通过配置热力值数据接口，自定义区域热力层的样式。区域热力层支持数据优先渲染。

选择区域热力层 > 数据 > 热力值数据接口。

选择数据源类型为静态数据，参数说明如下。热力值数据接口

上图中的示例JSON代码如下。

[
  {
    "area_id": "710000",
    "value": 64
  },
  {
    "area_id": "330000",
    "value": 388
  },
  {
    "area_id": "150000",
    "value": 82
  },
  {
    "area_id": "210000",
    "value": 478
  },
  {
    "area_id": "220000",
    "value": 491
  },
  {
    "area_id": "230000",
    "value": 849
  },
  {
    "area_id": "310000",
    "value": 273
  },
  {
    "area_id": "320000",
    "value": 656
  },
  {
    "area_id": "340000",
    "value": 157
  },
  {
    "area_id": "350000",
    "value": 764
  },
  {
    "area_id": "360000",
    "value": 797
  },
  {
    "area_id": "370000",
    "value": 337
  },
  {
    "area_id": "410000",
    "value": 32
  },
  {
    "area_id": "420000",
    "value": 225
  },
  {
    "area_id": "430000",
    "value": 693
  },
  {
    "area_id": "440000",
    "value": 19
  },
  {
    "area_id": "450000",
    "value": 141
  },
  {
    "area_id": "460000",
    "value": 906
  },
  {
    "area_id": "650000",
    "value": 904
  },
  {
    "area_id": "810000",
    "value": 526
  },
  {
    "area_id": "820000",
    "value": 407
  }
]

表 1. 字段说明
字段	说明
area_id	区域的adcode，可通过DataV.GeoAtlas获取。
value	地区的值，与配置面板中填充颜色的最大值、最小值、无数据配置项配合使用，可控制对应区域的颜色。说明根据数据的value区间得出scale区间，从而计算从最大到最小的颜色渐变区间。
info	（可选）弹窗内容。

您也可以在数据源中配置 color（线颜色）、weight（线宽）、dashArray（虚线）、fillColor（填充颜色）等字段。
地图中对应的区域将根据您设置的参数进行渲染。其中fillColor支持red、#fff000、rgba(0,256,0,0.5)三种形式设置参数，如下图所示。

表 2. 配置项说明
配置项	说明
受控模式	打开开关，资产初始化状态下不请求数据，仅通过回调ID或蓝图编辑器配置的方法发起请求数据；关闭开关，可以使用自动更新请求数据。开关默认为关闭状态。
自动更新请求	选中后可以设置动态轮询，还可以手动输入轮询的时间频次。取消选中后则不会自动更新，需要手动刷新页面，或通过蓝图编辑器和回调ID事件来触发请求更新数据。
数据源	单击配置数据源，可在设置数据源面板中修改数据源类型和数据查询代码、预览数据源返回结果以及查看数据响应结果，详情请参见配置资产数据。
数据过滤器	数据过滤器提供数据结构转换、筛选和一些简单的计算功能。单击添加过滤器，可在设置数据源面板配置数据过滤器脚本，详情请参见过滤器使用说明。
数据响应结果	展示数据请求的响应结果。当数据源发生改变时，可单击右侧的图标，实时查看数据响应结果。

交互

选中启用，开启组件交互功能。区域热力层子组件拥有交互配置，可单击某个区域、鼠标移入区域或鼠标移出区域时，触发数据请求，抛出回调值，实现在单击、鼠标移入或移出某个区域时，动态加载不同区域的数据。默认抛出所单击区域的area_id值，具体配置请参见组件回调ID配置。

蓝图编辑器交互配置

在画布编辑器页面，单击基础平面地图子组件管理列表中区域热力层右侧的图标。
单击页面左上角的图标。

在蓝图编辑器配置页面，单击导入节点栏内的区域热力层组件，在画布中可以看到如下图所示的区域热力层的蓝图编辑器配置参数。区域热力层蓝图编辑器参数

事件


事件	说明
当地理边界geojson数据接口请求完成时	地理边界geojson数据接口请求返回并经过过滤器处理后抛出的事件，同时抛出处理后的JSON格式的数据。具体数据请参见上文的数据示例。
当热力值数据接口请求完成时	热力值数据接口请求返回并经过过滤器处理后抛出的事件，同时抛出处理后的JSON格式的数据。具体数据请参见上文的数据示例。
点击区域时	当单击区域热力层某一块区域时抛出的事件参数，并交给下游组件处理。
鼠标移入区域触发	当鼠标移入区域热力层的某一区域块时触发事件并抛出数据。
鼠标移出区域触发	当鼠标移出区域热力层的某一区域块时触发事件并抛出数据。

动作


动作	说明
请求地理边界geojson数据接口	重新请求服务端数据，上游数据处理节点或图层节点抛出的数据将作为参数。例如区域热力层配置了API数据源为`http://api.test`，传到请求地理边界geojson数据接口动作的数据为`{ id: '1'}`，则最终请求接口为`http://api.test?id=1`。
请求热力值数据接口	重新请求服务端数据，上游数据处理节点或图层节点抛出的数据将作为参数。例如区域热力层配置了API数据源为`http://api.test`，传到请求热力值数据接口动作的数据为`{ id: '1'}`，则最终请求接口为`htp://api.test?id=1`。
导入地理边界geojson数据接口	按组件绘制格式处理数据后，导入组件，重新绘制。不需要重新请求服务端数据。具体数据请参见上文的数据示例。
导入热力值数据接口	按组件绘制格式处理数据后，导入组件，重新绘制。不需要重新请求服务端数据。具体数据请参见上文的数据示例。
显示	显示组件，不需要参数。
隐藏	隐藏组件，不需要参数。