GraphicGroupLayer

new mars3d.layer.GraphicGroupLayer(options)

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

参数名称 类型 描述信息
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 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>

子图层对象数组

继承自:

readonly hasChildLayer : boolean

是否有子图层

继承自:

hasEdit : boolean

是否可以编辑

readonly hasEmptyGroup : boolean

是否空组 ,空组目前就图层管理用于图层分组节点(虚拟节点)。

继承自:

readonly hasOpacity : boolean

是否可以调整透明度

继承自:

readonly hasZIndex : boolean

是否可以调整图层顺序(在同类型图层间)

继承自:

isAutoEditing : boolean

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

readonly length : number

子图层的个数

继承自:

selectedLayer : GraphicLayer

当前激活的图层

zIndex : number

图层顺序,数字大的在上面。(当hasZIndex为true时)

继承自:

方法

activateEdit()GraphicGroupLayer

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

返回值:

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

addChildsToMap()GroupLayer

添加所有子图层到map上

返回值:

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

继承自:

addLayer(childlayer)GroupLayer

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

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

子图层对象

返回值:

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

继承自:

clear(hasDestroy)void

清除图层内所有矢量数据

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

是否释放矢量对象

返回值:

createLayer(name)GraphicLayer

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

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

图层名称

返回值:

创建完成的图层

deleteEmptyLayer()GraphicGroupLayer

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

返回值:

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

deleteLayer(name)boolean

删除指定名称的图层

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

图层名称

返回值:

是否删除成功

disableEdit()GraphicGroupLayer

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

返回值:

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

eachGraphic(method, context)GraphicGroupLayer

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

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

回调方法

context object 可选

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

返回值:

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

eachLayer(method, context)GroupLayer

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

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

回调方法

context object 可选

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

返回值:

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

继承自:

getGraphicById(id)BaseGraphic|*

根据id或uuid取矢量数据对象

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

矢量数据id或uuid

返回值:

矢量数据对象

getGraphics()Array.<BaseGraphic>

获取图层内 所有矢量数据

返回值:

矢量数据数组

getInMapChilds()Array.<BaseLayer>|Array.<GraphicLayer>

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

返回值:

所有子图层对象

继承自:

getLayer(name)BaseLayer|GraphicLayer

根据id或name属性获取图层

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

图层id或uuid或name值

返回值:

图层对象

继承自:

getLayerById(id)BaseLayer|GraphicLayer|*

根据ID或取图层

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

图层id或uuid

返回值:

图层对象

继承自:

getLayers()Array.<BaseLayer>|Array.<GraphicLayer>

获取所有内置子图层对象

返回值:

所有子图层对象

继承自:

getRectangle(isFormat)Cesium.Rectangle|object

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

参数名称 类型 默认值 描述信息
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

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

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

图层名称

excludedLayer BaseLayer 可选

可以指定不进行判断的图层,比如当前图层本身

返回值:

是否同名

继承自:

isActivate(layer)boolean

判断图层是否激活状态

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

图层

返回值:

是否激活状态

loadGeoJSON(geojson, options)Array.<BaseGraphic>

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

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

GeoJSON格式规范数据

options object 可选

加载控制参数,包含:

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

是否清除图层已有数据

flyTo boolean false 可选

是否加载完成后进行飞行到数据区域

style object 可选

可以设置指定style样式

layer string 可选

指定导入所有数据到指定的图层

返回值:

转换后的Graphic对象数组

moveToLayer(graphic, layer)void

移动矢量对象到新分组

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

矢量对象

layer GraphicLayer

图层

返回值:

removeAllLayer()void

移除所有子图层

返回值:
继承自:

removeLayer(childlayer)GroupLayer

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

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

子图层对象

返回值:

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

继承自:

removeMapChilds()GroupLayer

将所有子图层从map中移除

返回值:

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

继承自:

startDraw(options)Promise.<(BaseGraphic|*)>

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

参数名称 类型 描述信息
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

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

返回值:

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

toBottom()void

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

返回值:

继承自:

toGeoJSON(options)object

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

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

参数对象:

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

不导出高度值

stopEdit boolean false 可选

是否停止绘制或编辑

返回值:

GeoJSON格式规范对象

toTop()void

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

返回值:

继承自: