图片背景层

图片背景层是基础平面地图的子组件，能够使用自定义的图片URL地址来设置基础平面地图的背景。与底图层不同的是，图片背景层使用的是本地或远程服务器上的图片，而底图层使用的是瓦片地址，两者可以配合使用。本文介绍背景层各配置项的含义。

单击子组件管理下方的图片背景层，进入配置面板配置图片背景层的样式和数据。

信息

说明 如果子组件管理中没有图片背景层，说明您还未添加图片背景层子组件，请参见地图容器进行添加。

配置

• 基础设置
  • 可见级别：设置图片背景层的可见级别值，在设定的级别范围内可见，级别之外不可见
• 默认样式：设置默认配置下的图片路径、透明度和图片范围等参数。 | 参数 | 说明 | | --- | --- | | 图片路径 | 输入图片的URL地址，将远程服务器上的图片作为背景图。 对于固定缩放等级的可视化应用设计需求，用户可以自己设计地图背景，作为地图底图，增强地图美感。 | | 透明度 | 图片背景层的透明度，范围为0~1。 | | 图片范围 | 可以通过左下角和右上角的X、Y坐标，来调整图片背景层的位置。其中X坐标的取值范围为[-180,180]，Y坐标的取值范围为[-90,90]。 |

信息

注意

• 在图片背景层配置面板内，仅支持配置一张背景图。
• 当数据面板内有配置图片数据，配置面板内设置的图片参数就不生效。
• 如果您只需要配置一张背景图，可以选择在配置面板直接添加并设置图片相关参数，也可以选择在数据面板添加图片对应的字段数据来配置背景图，两种方式选其一即可。
• 如果您需要配置多张背景图，则必须通过在数据面板内添加多张图片对应的字段数据来实现。

数据

字段说明

字段	说明
imageUrl	（可选）图片的URL地址。
opacity	（可选）图片的透明度值。
bounds	（可选）图片范围值。

配置项说明

配置项	说明
受控模式	打开开关，组件初始化状态下不请求数据，仅通过回调 ID 或蓝图编辑器配置的方法发起请求数据；关闭开关，可以使用自动更新请求数据。
自动更新请求	选中后可以设置动态轮询，还可以手动输入轮询的时间频次。
数据源	修改数据源类型和数据查询代码
数据响应结果	展示数据请求的响应结果。当数据源发生改变时，可单击下方刷新数据，点击查看响应数据可实时查看数据响应结果。

交互

此组件没有交互事件。

蓝图编辑器交互配置

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

事件

当图片数据接口请求完成时：图片数据接口请求返回并经过过滤器处理后抛出的事件，同时抛出处理后的 JSON 格式的数据。具体数据请参见上文的 数据示例。

动作

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