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

注意 当前为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粘贴到数据输入区,如下图所示。使用JSON API数据

        上图中提取到了肇庆市包含子区域的边界信息,示例API如下。

        https://geo.datav.aliyun.com/areas/bound/441200_full.json
      4. 发布大屏项目,可以看到配置的区域热力层。
    在数据配置的过程中,可能会出现区域文字标注有偏移的问题,解决方法如下。
    • 查看下您的区域热力层版本,目前可以使用的区域热力层组件包括区域热力层v0.2.4及以上版本。如果您使用的区域热力层版本较低,需要先删除该层,再重新添加。
    • GeoJSON提取工具中的数据已更新,需使用新的GeoJSON API。
    • 修改参数。
      肇庆市的区县级GeoJSON数据为例,高要区文字标注有偏移。地理位置偏移
      1. 使用geojson.io工具,添加customLabelPosition属性参数。
        在数据区域找到高要区properties参数,添加自定义"customLabelPosition": [112.500801,22.927694]属性。添加properties参数
      2. 保存修改后的API到您的服务器上。
      3. 选择区域热力层 > 数据 > 地理边界geojson数据接口
      4. 单击配置数据源,在设置数据源面板中选择数据源类型API
      5. 将修改后的JSON API地址粘贴到数据输入区,设置完成后,高要区标注显示正常。
  • 热力值数据接口

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

    1. 选择区域热力层 > 数据 > 热力值数据接口
    2. 选择数据源类型静态数据,参数说明如下。热力值数据接口

      上图中的示例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 (可选)弹窗内容。
    3. 您也可以在数据源中配置 color(线颜色)、weight(线宽)、dashArray(虚线)、fillColor(填充颜色)等字段。
      地图中对应的区域将根据您设置的参数进行渲染。其中fillColor支持red#fff000rgba(0,256,0,0.5)三种形式设置参数,如下图所示。配置地图边界样式
表 2. 配置项说明
配置项 说明
受控模式 打开开关,组件初始化状态下不请求数据,仅通过回调ID或蓝图编辑器配置的方法发起请求数据;关闭开关,可以使用自动更新请求数据。
自动更新请求 选中后可以设置动态轮询,还可以手动输入轮询的时间频次。
数据源 单击配置数据源,可在设置数据源页面中修改数据源类型和数据查询代码、预览数据源返回结果以及查看数据响应结果。详情请参见配置组件数据
数据过滤器 单击添加过滤器,可在设置数据源页面中配置数据过滤器,详情请参见组件过滤器使用说明
数据响应结果 展示数据请求的响应结果。当数据源发生改变时,可单击右侧的刷新数据图标,实时查看数据响应结果。

交互

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

蓝图编辑器交互配置

  1. 在画布编辑器页面,单击基础平面地图子组件管理列表中区域热力层右侧的导出到蓝图编辑器图标。
  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数据接口 按组件绘制格式处理数据后,导入组件,重新绘制。不需要重新请求服务端数据。具体数据请参见上文的数据示例
      导入热力值数据接口 按组件绘制格式处理数据后,导入组件,重新绘制。不需要重新请求服务端数据。具体数据请参见上文的数据示例
      显示 显示组件,不需要参数。
      隐藏 隐藏组件,不需要参数。