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

注意 当前为v1.x版本的背景层子组件指导文档，如需查看该子组件v2.x版本的文档内容详情，请参见图片背景层（v2.x版本）。
单击子组件管理下方的背景层，进入配置面板配置背景层的样式和数据。
说明 如果子组件管理中没有背景层，说明您还未添加背景层子组件，请参见地图容器（v1.x版本）进行添加。

配置

背景层配置面板
  • 搜索配置：单击配置面板右上角的搜索配置，可在搜索配置对话框中输入您需要搜索的配置项名称，快速定位到该配置项，系统支持模糊匹配。详情请参见搜索组件配置。
  • 坐标参考系：坐标参考系类别，包括EPSG3857和Simple两种类别。
    • EPSG3857：是一种地图坐标系，可以通过左下角和右上角的X、Y坐标，来调整背景层的位置。其中X坐标的取值范围为[-180,180]，Y坐标的取值范围为[-90,90]。
    • Simple：即常见的直角坐标系，可以通过左下角和右上角的X、Y坐标，来调整背景层的位置。其中X、Y坐标的取值范围都为[-200,200]。
  • 自定义背景：在自定义背景区域，单击删除当前图片，再次单击重新上传本地图片。您也可以输入图片的URL地址，将远程服务器上的图片作为背景图。

    对于固定缩放等级的可视化应用设计需求，用户可以自己设计地图背景，作为地图底图，增强地图美感。

  • 透明：背景层的透明度，范围为0~1。

数据

背景层数据面板

url：（可选）图片的URL地址，如果为空，则使用配置面板中配置的图片，如果不为空，则优先使用URL地址中的图片。

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

交互

此组件没有交互事件。

蓝图编辑器交互配置

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

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

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