中国国家边界是基础平面地图的子组件，支持独立的样式和数据配置，包括底中国国家边界、省界和海岸线的线条样式的配置，也可对地图内各省和直辖市地区的标注进行统一的配置等。本文介绍中国国家边界各配置项的含义。
配置
- 搜索配置：单击配置面板右上角的搜索配置，可在搜索配置面板中输入您需要搜索的配置项名称，快速定位到该配置项，系统支持模糊匹配。详情请参见搜索资产配置。
- 可见级别：设置中国国家边界的可见级别值，在设定的级别范围内中国国家边界可见，级别之外不可见。
- 填充颜色：数据中最大、最小及为数据为空的value值对应区域的颜色，请参见颜色选择器说明进行修改。
说明 填充颜色配置项功能，对应数据面板中的fillColor字段。如果两者都进行了配置，DataV优先使用数据中的配置。
- 线样式
参数 说明 国界颜色、国界粗细 设置国界线的颜色和线条粗细大小。 省界颜色、省界粗细 设置省界线的颜色和线条粗细大小。 海岸线颜色、海岸线粗细 设置海岸线的颜色和线条粗细大小。 - 标注：中国国家边界内各个区域标注内容的样式，单击左侧
图标，即可控制标注的显隐。
参数 说明 图标颜色 区域内图标的颜色，请参见颜色选择器说明进行修改。 文本样式 图标内的文本内容的样式，包括文本的字体样式、文字粗细、字号大小、文字颜色和文字阴影色。 - 附图：中国国家边界地图右下角附图内容的样式，单击左侧图标，即可控制附图的显隐。
参数 说明 陆地填充色 附图中陆地部分的填充颜色，请参见颜色选择器说明进行修改。 海洋填充色 附图中海洋部分的填充颜色，请参见颜色选择器说明进行修改。 边框颜色 附图部分的边框线颜色，请参见颜色选择器说明进行修改。 边框粗细 附图部分的边框线的粗细值，单位为px，取值范围1~20。 右侧距离 附图部分离组件范围最右侧的距离，单位为px，取值范围0~500。 底部距离 附图部分离组件范围最底部的距离，单位为px，取值范围0~500。 缩放比例 附图部分内容显示的大小缩放比例，取值范围0.1~10。
数据
热力值数据接口：您可以通过配置热力值数据接口，自定义区域热力层的样式。区域热力层支持数据优先渲染。上图中的示例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
}
]| 字段 | 说明 |
|---|---|
| area_id | 区域的adcode编号，可通过DataV.GeoAtlas获取。 |
| name | （可选）地图中地区的名称。 |
| value | （可选）地区的值，与配置面板中填充颜色的最大值、最小值、无数据配置项配合使用，可控制对应区域的颜色。
说明 根据数据的value区间得出scale区间，从而计算从最大到最小的颜色渐变区间。
|
| info | （可选）弹窗内容。 |
说明 您也可以在数据源中配置fillColor（填充颜色）字段内容。
地图中对应的区域将根据您设置的参数进行渲染。其中fillColor支持red、#fff000、rgba(0,256,0,0.5)三种形式设置参数，如下图所示。
| 配置项 | 说明 |
|---|---|
| 受控模式 | 打开开关，资产初始化状态下不请求数据，仅通过回调ID或蓝图编辑器配置的方法发起请求数据；关闭开关，可以使用自动更新请求数据。开关默认为关闭状态。 |
| 自动更新请求 | 选中后可以设置动态轮询，还可以手动输入轮询的时间频次。取消选中后则不会自动更新，需要手动刷新页面，或通过蓝图编辑器和回调ID事件来触发请求更新数据。 |
| 数据源 | 单击配置数据源，可在设置数据源面板中修改数据源类型和数据查询代码、预览数据源返回结果以及查看数据响应结果，详情请参见配置资产数据。 |
| 数据过滤器 | 数据过滤器提供数据结构转换、筛选和一些简单的计算功能。单击添加过滤器，可在设置数据源面板配置数据过滤器脚本，详情请参见过滤器使用说明。 |
| 数据响应结果 | 展示数据请求的响应结果。当数据源发生改变时，可单击右侧的 图标，实时查看数据响应结果。
|
交互
此组件没有交互事件。
蓝图编辑器交互配置
- 在画布编辑器页面，单击基础平面地图子组件管理列表中中国国家边界右侧的
图标。
- 单击页面左上角的
图标。
- 在蓝图编辑器配置页面，单击导入节点栏内的中国国家边界组件，在画布中可以看到如下图所示的中国国家边界的蓝图编辑器配置参数。
- 事件
事件 说明 当热力值数据接口请求完成时 数据接口请求返回并经过过滤器处理后抛出的事件，同时抛出处理后的JSON格式的数据。具体数据示例请参见画布编辑器中组件右侧配置面板数据页签的数据响应结果区域。 当热力值数据接口请求失败时 数据接口请求失败时（请求失败的情况可能是：网络问题或接口报错等）返回并经过过滤器处理后抛出的事件，同时抛出处理后的JSON格式的数据。具体数据示例请参见画布编辑器中组件右侧配置面板数据页签的数据响应结果区域。 - 动作
动作 说明 请求热力值数据接口 重新请求服务端数据，上游数据处理节点或图层节点抛出的数据将作为参数。例如中国国家边界配置了API数据源为 http://api.test，传到请求热力值数据接口动作的数据为{ id: '1'}，则最终请求接口为htp://api.test?id=1。导入热力值数据接口 按组件绘制格式处理数据后，导入组件，重新绘制。不需要重新请求服务端数据。具体数据示例请参见画布编辑器中组件右侧配置面板数据页签的数据响应结果区域。 显示 显示组件，不需要参数。 隐藏 隐藏组件，不需要参数。
- 事件