区域热力层

配置

• 搜索配置：单击配置面板右上角的搜索配置，可在搜索配置面板中输入您需要搜索的配置项名称，快速定位到该配置项，系统支持模糊匹配。详情请参见搜索资产配置。
• 填充颜色：设置数据中最大、最小及为空的value值对应区域的填充颜色。
• 边线样式：区域热力层各区域边线的颜色。
• 文本样式：区域热力层各区域文本标注的字体系列、文本粗细、字号、颜色、文本描边粗细和描边颜色，请参见颜色选择器说明进行颜色修改。 单击图标控制文本样式的显隐。
  说明 请选择系统中的字体，如果您的系统中没有所选的字体，标注会使用默认字体。

数据

• 地理边界geojson数据接口：区域热力层子组件在添加后会根据当前的3D平面地图的父组件所选区域，初始化子组件的地理边界geojson数据。

  如果您想自定义修改默认的区域热力层地理边界geojson数据，可以通过配置地理边界geojson数据接口，可将提取到的区域GeoJSON边界数据应用到DataV中，配置方法如下。

  1. 数据提取。
     使用GeoJSON行政区划边界提取小工具DataV.GeoAtlas，最低可以提取区县级边界数据，区域adcode可以查阅省市区adcode与经纬度映射表，提取方法如下。

     • 省级：区域热力层默认显示为全国范围内，各个省和直辖市区域热力层数据，可以直接使用。
     • 地市级：以提取浙江省范围内所有地级市边界数据为例，提取方法如下图所示。
  2. 数据应用。
     将提取到的数据配置到DataV中，配置方法如下。

     1. 选择区域热力层 > 数据 > 地理边界geojson数据接口。
     2. 单击配置数据源，在设置数据源对话框中，选择数据源类型为API。
     3. 设置请求方式为GET。
     4. 将提取到的JSON API粘贴到数据输入区，如下图所示。

        上图中提取到了区域的边界信息，示例API如下。

        https://geo.datav.aliyun.com/areas_v2/bound/330200_full.json

     5. 发布可视化应用项目。
        • 如果修改后的区域数据还在父组件区域范围内，可以看到配置后的子组件区域热力层内容。
        • 如果修改后的区域数据与父组件区域范围无任何交集，无法看到配置后的子组件区域热力层内容。

  在数据配置的过程中，可能会出现区域文字标注有偏移的问题，解决方法请参考基础平面地图中区域热力层子组件内的文字标注偏移解决方案。

• 热力值数据接口

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

  1. 选择区域热力层 > 数据 > 热力值数据接口。
  2. 选择数据源类型为静态数据，参数说明如下。
     上图中的示例JSON代码如下。

     [
       {
         "area_id": "330203",
         "value": 72,
         "name": "海曙区"
       },
       {
         "area_id": "330205",
         "value": 21,
         "name": "江北区"
       },
       {
         "area_id": "330206",
         "value": 99,
         "name": "北仑区"
       },
       {
         "area_id": "330211",
         "value": 43,
         "name": "镇海区"
       },
       {
         "area_id": "330212",
         "value": 10,
         "name": "鄞州区"
       },
       {
         "area_id": "330213",
         "value": 35,
         "name": "奉化区"
       },
       {
         "area_id": "330225",
         "value": 82,
         "name": "象山县"
       },
       {
         "area_id": "330226",
         "value": 77,
         "name": "宁海县"
       },
       {
         "area_id": "330281",
         "value": 92,
         "name": "余姚市"
       },
       {
         "area_id": "330282",
         "value": 48,
         "name": "慈溪市"
       }
     ]

     表 1. 字段说明

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

  3. 您也可以在数据源中配置fillColor字段。
     地图中对应的区域将根据您设置的参数进行渲染。其中fillColor支持red、#fff000、rgba(0,256,0,0.5)三种形式设置参数，如下图所示。

表 2. 配置项说明

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

交互

该组件无交互事件。

蓝图编辑器交互配置

1. 在画布编辑器页面，单击3D平面地图子组件管理列表中区域热力层右侧的图标。
2. 单击页面左上角的图标。
3. 在蓝图编辑器配置页面，单击导入节点栏内的区域热力层组件，在画布中可以看到如下图所示的区域热力层的蓝图编辑器配置参数。
   • 事件

     事件	说明
     当地理边界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数据接口	按组件绘制格式处理数据后，导入组件，重新绘制。不需要重新请求服务端数据。具体数据请参见上文的数据示例。
     导入热力值数据接口	按组件绘制格式处理数据后，导入组件，重新绘制。不需要重新请求服务端数据。具体数据请参见上文的数据示例。
     显示组件	显示组件，不需要参数。
     隐藏组件	隐藏组件，不需要参数。