layer~PointLayer(name, options)

点图层,用来对点状矢量要素统一管理。

Summary

Methods:
addFeature

添加的单个地理要素。每调用一次,图层就会重绘一次。

addFeatures

添加的多个地理要素。每调用一次,图层就会重绘一次。

getAllFeatures

获取所有要素。

getFeatureByFid

根据id获取指定的要素。

getFeaturesByAttribute

给定属性与值,获取匹配的地理要素。
如果没有找到匹配的地理要素,则返回一个空的数组。

removeAllFeatures

删除所有地理要素。

removeFeature

删除单个点状地理要素。

removeFeatures

删除一组地理要素。

setStyle

设置样式,重新设置需要等数据加载完成后调用

updateFeature

更新已添加到图层中的指定的feature。

updateFeatures

更新已添加到图层中的指定feature数组。

Constructor

new PointLayer(name, options)

Parameters:
Name Type Description
name String

图层名称

options Object

参数项

Name Type Description
style Object

点图层中点状元素样式,可参考模块 module:feature~PointFeature

blockSize Number

图层中每组要素的数量,默认为200,即在绘制图层时要素以200的数量进行分组。

clampToGround Boolean

是否贴地形绘制,默认为false,如果开启,需要再指定三维基础图层,图层中的要素会贴三维基础图层绘制。矢量图层中的点要素会在自身高度的基础上,再追加地形高度,如果点要素需要完全贴地形,需要将原始点位的z值设置为0。

opacity Number

设置图层透明度,介于0~1之间,0表示完全透明,1表示完全不透明。默认为1.0,完全不透明。

Members

clampToGround

设置贴地状态

Overrides:

depthTest

获取图层的深度测试属性
return {Boolean} 深度测试属性

Overrides:

Methods

addFeature(feature)

添加的单个地理要素。每调用一次,图层就会重绘一次。

Parameters:
Name Type Description
feature module:feature~PointFeature

要添加的地理要素

Example
Pointlayer.addFeature(PointFeature)

addFeatures(features)

添加的多个地理要素。每调用一次,图层就会重绘一次。

Parameters:
Name Type Description
features Array.<module:feature~PointFeature>

要添加的点状要素数组

Example
Pointlayer.addFeatures([PointFeature])

getAllFeatures() → {Array.<module:feature~PointFeature>}

获取所有要素。

Returns:
Array.<module:feature~PointFeature> -

返回图层的所有点状要素

getFeatureByFid(id) → {module:feature~PointFeature}

根据id获取指定的要素。

Parameters:
Name Type Description
id string

点状要素的id

Returns:
module:feature~PointFeature -

id对应的点状要素

getFeaturesByAttribute(attrName, attrValue) → {Array.<module:feature~PointFeature>}

给定属性与值,获取匹配的地理要素。
如果没有找到匹配的地理要素,则返回一个空的数组。

Parameters:
Name Type Description
attrName String

属性名称或键名

attrValue *

属性值。字符串、数字等

Returns:
Array.<module:feature~PointFeature> -

返回所匹配的要素构成的数组

Example
let features = PointLayer.getFeaturesByAttribute("name", 205);//得到属性name为205的点状要素数组

removeAllFeatures()

删除所有地理要素。

Example
PointLayer.removeAllFeatures();

removeFeature(feature)

删除单个点状地理要素。

Parameters:
Name Type Description
feature module:feature~PointFeature

要删除的点状地理要素

Example
PointLayer.removeFeature(PointFeature);

removeFeatures(features)

删除一组地理要素。

Parameters:
Name Type Description
features Array.<module:feature~PointFeature>

删除指定的地理要素要素数组

Example
vectorLayer.removeFeatures([feature]);

setStyle(style)

设置样式,重新设置需要等数据加载完成后调用

Parameters:
Name Type Description
style JSON

点样式,具体格式参考图层初始化style参数。

Example
style = { //图标样式
    point:{
        offset:Array<Number>,
        size:Array<Number>,
        imgUrl:String,
        rotate:Number,
        opacity:Number,
        },
    label:{
        name:String,
        offset:Array<Number>,
        fontColor:Array<Number>,
        fontWeight:String,
        fontSize:Number,
        fontFace:String,
        fontStyle:String,
        }
    }

updateFeature(feature)

更新已添加到图层中的指定的feature。

Parameters:
Name Type Description
feature module:feature~PointFeature

需要更新的点状要素

updateFeatures(features)

更新已添加到图层中的指定feature数组。

Parameters:
Name Type Description
features Array.<module:feature~PointFeature>

需要更新的点状要素数组