GraphicGroupLayer
查阅Cesium API

new mars3d.layer.GraphicGroupLayer(options)
layer/graphicLayer/GraphicGroupLayer.js 8

矢量数据图层组，主要用于 多图层的标绘

参数名称 类型 描述信息
options object 可选

参数对象，包括以下：

参数名称 类型 默认值 描述信息
layers Array.<GraphicLayer> 可选

子图层数组，每个子图层的配置见按各类型图层配置即可。
defaultLayer string 可选

默认图层的图层名称
hasEdit boolean false 可选

是否自动激活编辑（true时，单击后自动激活编辑）
isAutoEditing boolean true 可选

完成标绘时是否自动启动编辑(需要hasEdit:true时)
isContinued boolean false 可选

是否连续标绘
isRestorePositions boolean false 可选

在标绘和编辑结束时，是否将坐标还原为普通值，true: 停止编辑时会有闪烁，但效率要好些。
id string | number mars3d.Util.createGuid() 可选

图层id标识
pid string | number -1 可选

图层父级的id，一般图层管理中使用
name string '' 可选

图层名称
show boolean true 可选

图层是否显示
eventParent BaseClass | boolean 可选

指定的事件冒泡对象，默认为map对象，false时不冒泡
center object 可选

图层自定义定位视角 Map#setCameraView

参数名称 类型 描述信息
lng number

经度值, 180 - 180
lat number

纬度值, -90 - 90
alt number 可选

高度值
heading number 可选

方向角度值，绕垂直于地心的轴旋转角度, 0至360
pitch number 可选

俯仰角度值，绕纬度线旋转角度, -90至90
roll number 可选

翻滚角度值，绕经度线旋转角度, -90至90
flyTo boolean 可选

加载完成数据后是否自动飞行定位到数据所在的区域。
flyToOptions object 可选

加载完成数据后是否自动飞行定位到数据所在的区域的对应 BaseLayer#flyTo方法参数。

继承

成员(属性)

readonly arrLayer : Array.<BaseLayer>|Array.<GraphicLayer>
layer/GroupLayer.js 50

子图层对象数组

继承自:

readonly hasChildLayer : boolean
layer/GroupLayer.js 70

是否有子图层

继承自:

hasEdit : boolean
layer/graphicLayer/GraphicGroupLayer.js 45

是否可以编辑

readonly hasEmptyGroup : boolean
layer/GroupLayer.js 60

是否空组 ，空组目前就图层管理用于图层分组节点（虚拟节点）。

继承自:

readonly hasOpacity : boolean
layer/GroupLayer.js 94

是否可以调整透明度

继承自:

readonly hasZIndex : boolean
layer/GroupLayer.js 110

是否可以调整图层顺序（在同类型图层间）

继承自:

isAutoEditing : boolean
layer/graphicLayer/GraphicGroupLayer.js 64

完成标绘时是否自动启动编辑(需要hasEdit:true时)

readonly length : number
layer/GroupLayer.js 80

子图层的个数

继承自:

selectedLayer : GraphicLayer
layer/graphicLayer/GraphicGroupLayer.js 79

当前激活的图层

zIndex : number
layer/GroupLayer.js 121

图层顺序，数字大的在上面。（当hasZIndex为true时）

继承自:

方法

activateEdit() → GraphicGroupLayer
layer/graphicLayer/GraphicGroupLayer.js 534

激活编辑，绑定相关处理，同 hasEdit=true

返回值:

当前对象本身,可以链式调用

addChildsToMap() → GroupLayer
layer/GroupLayer.js 204

添加所有子图层到map上

返回值:

当前对象本身，可以链式调用

继承自:

addLayer(childlayer) → GroupLayer
layer/GroupLayer.js 226

添加子图层，并绑定关联关系。

参数名称 类型 描述信息
childlayer BaseLayer | GraphicLayer

子图层对象
返回值:

当前对象本身，可以链式调用

继承自:

clear(hasDestroy) → void
layer/graphicLayer/GraphicGroupLayer.js 336

清除图层内所有矢量数据

参数名称 类型 默认值 描述信息
hasDestroy boolean true 可选

是否释放矢量对象
返回值:

无

createLayer(name) → GraphicLayer
layer/graphicLayer/GraphicGroupLayer.js 172

创建并添加指定名称的图层

参数名称 类型 描述信息
name string

图层名称
返回值:

创建完成的图层

deleteEmptyLayer() → GraphicGroupLayer
layer/graphicLayer/GraphicGroupLayer.js 234

删除所有没有数据的矢量图层

返回值:

当前对象本身，可以链式调用

deleteLayer(name) → boolean
layer/graphicLayer/GraphicGroupLayer.js 207

删除指定名称的图层

参数名称 类型 描述信息
name string

图层名称
返回值:

是否删除成功

disableEdit() → GraphicGroupLayer
layer/graphicLayer/GraphicGroupLayer.js 542

释放编辑，解除绑定相关事件，同 hasEdit=false

返回值:

当前对象本身,可以链式调用

eachGraphic(method, context) → GraphicGroupLayer
layer/graphicLayer/GraphicGroupLayer.js 323

遍历所有矢量数据并将其作为参数传递给回调函数

参数名称 类型 描述信息
method function

回调方法
context object 可选

侦听器的上下文(this关键字将指向的对象)。
返回值:

当前对象本身,可以链式调用

eachLayer(method, context) → GroupLayer
layer/GroupLayer.js 284

遍历每一个子图层并将其作为参数传递给回调函数

参数名称 类型 描述信息
method function

回调方法
context object 可选

侦听器的上下文(this关键字将指向的对象)。
返回值:

当前对象本身,可以链式调用

继承自:

getGraphicById(id) → BaseGraphic|*
layer/graphicLayer/GraphicGroupLayer.js 302

根据id取矢量数据对象

参数名称 类型 描述信息
id string | number

矢量数据id
返回值:

矢量数据对象

getGraphics() → Array.<BaseGraphic>
layer/graphicLayer/GraphicGroupLayer.js 284

获取图层内 所有矢量数据

返回值:

矢量数据数组

getInMapChilds() → Array.<BaseLayer>|Array.<GraphicLayer>
layer/GroupLayer.js 306

获取地图所有的子图层对象(包括pid和id关联的图层)

返回值:

所有子图层对象

继承自:

getLayer(name) → BaseLayer|GraphicLayer
layer/GroupLayer.js 347

根据id或name属性获取图层

参数名称 类型 描述信息
name string | number

图层id或name值
返回值:

图层对象

继承自:

getLayerById(id) → BaseLayer|GraphicLayer|*
layer/GroupLayer.js 327

根据ID或取图层

参数名称 类型 描述信息
id string | number

图层id
返回值:

图层对象

继承自:

getLayers() → Array.<BaseLayer>|Array.<GraphicLayer>
layer/GroupLayer.js 298

获取所有内置子图层对象

返回值:

所有子图层对象

继承自:

getRectangle(isFormat) → Cesium.Rectangle|object
layer/graphicLayer/GraphicGroupLayer.js 469

获取图层内所有数据的 矩形边界值

参数名称 类型 默认值 描述信息
isFormat boolean false 可选

是否格式化，格式化时示例： { xmin: 73.16895, xmax: 134.86816, ymin: 12.2023, ymax: 54.11485 }
返回值:

isFormat：true时，返回格式化对象，isFormat：false时返回Cesium.Rectangle对象

hasLayer(name, excludedLayer) → boolean
layer/GroupLayer.js 367

是否有同名的子图层，一般用于新增时判断

参数名称 类型 描述信息
name string

图层名称
excludedLayer BaseLayer 可选

可以指定不进行判断的图层，比如当前图层本身
返回值:

是否同名

继承自:

isActivate(layer) → boolean
layer/graphicLayer/GraphicGroupLayer.js 111

判断图层是否激活状态

参数名称 类型 描述信息
layer GraphicLayer

图层
返回值:

是否激活状态

loadGeoJSON(geojson, options) → Array.<BaseGraphic>
layer/graphicLayer/GraphicGroupLayer.js 392

加载转换GeoJSON格式规范数据为Graphic后加载到图层中。

参数名称 类型 描述信息
geojson string | object

GeoJSON格式规范数据
options object 可选

加载控制参数,包含：

参数名称 类型 默认值 描述信息
clear boolean false 可选

是否清除图层已有数据
flyTo boolean false 可选

是否加载完成后进行飞行到数据区域
style object 可选

可以设置指定style样式
layer string 可选

指定导入所有数据到指定的图层
返回值:

转换后的Graphic对象数组

moveToLayer(graphic, layer) → void
layer/graphicLayer/GraphicGroupLayer.js 271

移动矢量对象到新分组

参数名称 类型 描述信息
graphic BaseGraphic | *

矢量对象
layer GraphicLayer

图层
返回值:

无

reload() → void
layer/GroupLayer.js 464

重新加载图层

返回值:

无

继承自:

removeAllLayer() → void
layer/GroupLayer.js 269

移除所有子图层

返回值:
继承自:

removeLayer(childlayer) → GroupLayer
layer/GroupLayer.js 253

移除子图层，并解除关联关系。

参数名称 类型 描述信息
childlayer BaseLayer | GraphicLayer

子图层对象
返回值:

当前对象本身，可以链式调用

继承自:

removeMapChilds() → GroupLayer
layer/GroupLayer.js 214

将所有子图层从map中移除

返回值:

当前对象本身，可以链式调用

继承自:

startDraw(options) → Promise.<(BaseGraphic|*)>
layer/graphicLayer/GraphicGroupLayer.js 517

开始绘制矢量数据，绘制的数据会加载在当前图层。

参数名称 类型 描述信息
options object | *

绘制参数，包含：

参数名称 类型 默认值 描述信息
type GraphicType | string

类型
style object 可选

矢量数据样式，具体参考支持 GraphicType查询对应type的类
attr object 可选

矢量数据的 属性信息，可以任意附加属性。
success function 可选

绘制创建完成的回调方法，同drawCreated事件，例如： success: function (graphic){ } //以下为Entity支持的构造参数
name string 可选

矢量数据名称
maxPointNum number 可选

线面数据时限定的最大坐标个数
drawShow boolean true 可选

绘制时，是否自动隐藏entity，可避免拾取坐标存在问题。
addHeight number 可选

在绘制时，在绘制点的基础上增加的高度值
availability Cesium.TimeIntervalCollection | Cesium.TimeInterval | Array | object 可选

指定时间范围内显示该对象
description Cesium.Property | string 可选

指定此实体的HTML描述的字符串属性（infoBox中展示）。
返回值:

绘制创建完成的Promise,等价于success参数

stopDraw() → GraphicGroupLayer
layer/graphicLayer/GraphicGroupLayer.js 526

停止绘制，如有未完成的绘制会自动删除

返回值:

当前对象本身,可以链式调用

toBottom() → void
layer/GroupLayer.js 452

将当前图层在map中层级进行 置底(只对同类型图层间有效)

返回值:

无

继承自:

toGeoJSON(options) → object
layer/graphicLayer/GraphicGroupLayer.js 349

将图层数据导出为GeoJSON格式规范对象。

参数名称 类型 描述信息
options object 可选

参数对象:

参数名称 类型 默认值 描述信息
noAlt boolean 可选

不导出高度值
stopEdit boolean false 可选

是否停止绘制或编辑
返回值:

GeoJSON格式规范对象

toTop() → void
layer/GroupLayer.js 442

将当前图层在map中层级进行 置顶(只对同类型图层间有效)。

返回值:

无

继承自: