YSLayers

图层

new YS.YSLayers()

图层操作相关。这个类仅为文档化方便而虚拟,使用示例:YouScene.layers.addImageLayer

Methods

staticYS.YSLayers.addArcGISServerLayer(options)ArcGISServerLayer

添加ArcGISLayer图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Description
id String optional 唯一标识
name String optional 名称
url String url
layer String 请求图层Key,默认显示所有图层
maximumLevel Number optional 最大级数
tileWidth Number optional 切片宽度
tileHeitht Number optional 切片高度
category String optional 图层分组
isAddTree Boolean optional 是否在图层树上显示
treeIcon String optional 图层树上显示的图标,默认不显示
visible Boolean optional 是否可见
Returns:
ArcGISServerLayer 对象

staticYS.YSLayers.addContourLayer(options)ContourLayer

添加等值面图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id String optional 唯一标识
name String optional 名称
rectangle Rectangle optional 等高线绘制范围{west, south, east, north}
category String optional 图层分组
isAddTree Boolean optional 是否在图层树上显示
treeIcon String optional 图层树上显示的图标,默认不显示
visible Boolean optional 是否可见
majorContour Number 200 optional 主等高线的间隔值,即默认每200米绘制一条粗线
minorContour Number 50 optional 等高线的间隔值,即默认每50米绘制一条细线
minimumLevel Number 6 optional 等高线的起始绘制级别
fontSize Number 6 optional 等高线上注记的字号
contourColor Color Color.WHITE optional 等高线的颜色
gradient Array.<Object> optional 等高面的底色,有默认预定义
Name Type Description
color Color optional 等高面的底色,支持透明度
value Number optional 等高面的高程值
insertPosition Number optional 添加的位置,默认添加到最后,即叠加到最上层
Returns:
等高线图层对象

staticYS.YSLayers.addGaodeLayer(options)GaodeLayer

添加高德地图图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id string optional 唯一标识
url String optional Google服务url
layer String optional 请求图层Key
name String optional 图层名称
minimumLevel Number 0 optional 最小级数
maximumLevel Number optional 最大级数
insertPosition Number optional 添加的位置,默认添加到最后,即叠加到最上层
rectangle Object optional 切片图层地理范围 {west: -180,south: -90,east: 180,north: 90}
category String optional 图层分类名称
isAddTree Boolean false optional 是否添加到图层树上
treeIcon String optional 图层树上显示的图标,默认不显示
visible Boolean true optional 是否可见
Returns:
GaodeLayer 对象

staticYS.YSLayers.addGeoJsonLayer(options)GeoJsonLayer

添加GeoJson图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id String optional 唯一标识
name String optional 名称
category String optional 图层分组
rectangle Object optional 范围{west, south, east, north}
url String 已废弃,请使用options.data
data String | Object 要加载的geoJson文件url地址或者geoJson对象、TopoJson对象
strokeWidth Number 0.1 optional 轮廓线宽
strokeColor Color {r:1,g:1,b:1,a:1} optional 轮廓颜色
fillColor Color {r:0,g:0,b:0,a:0} optional 填充颜色
clampToGround Boolean false optional 是否贴地, 该项默认为false, 此时填充颜色易被地形遮住; 若该项设为true, 则无法显示轮廓线
isAddTree Boolean false optional 是否加入树
treeIcon String optional 图层树上显示的图标,默认不显示
visible Boolean true optional 是否可见
Returns:
GeoJsonLayer
Deprecated:  v1.18已废弃options.url参数请改用options.data

staticYS.YSLayers.addGoogleLayer(options)GoogleLayer

添加GoogleLayer图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id string optional 唯一标识
url String optional Google服务url
lyrs String 请求图层Key
name String optional 图层名称
minimumLevel Number 0 optional 最小级数
maximumLevel Number optional 最大级数
insertPosition Number optional 添加的位置,默认添加到最后,即叠加到最上层
rectangle Object optional 切片图层地理范围 {west: -180,south: -90,east: 180,north: 90}
category String optional 图层分类名称
isAddTree Boolean false optional 是否添加到图层树上
treeIcon String optional 图层树上显示的图标,默认不显示
visible Boolean true optional 是否可见
Returns:
GoogleLayer 对象

staticYS.YSLayers.addGraphicsLayer(options)GraphicsLayer

添加矢量几何形状图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id String optional 唯一标识
name String optional 名称
category String optional 图层分组
visible Boolean true optional 是否可见
isAddTree Boolean true optional 是否添加到图层树上
treeIcon String optional 图层树上显示的图标,默认不显示
Returns:
GraphicsLayer 对象

staticYS.YSLayers.addHeatMapLayer(options)ContourLayer

添加热力图图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Description
id String optional 唯一标识
name String optional 名称
category String optional 图层分组
isAddTree Boolean optional 是否在图层树上显示
treeIcon String optional 图层树上显示的图标,默认不显示
visible Boolean optional 是否可见
rectangle Rectangle optional 范围{west, south, east, north}
heatmap Object optional heatmap相应参数
Name Type Default Description
backgroundColor RGBA {r:0,g:0,b:0,a:0} optional 热力图的背景色
radius Number optional 半径,(单位像素),每个数据点的半径
maxOpacity Number optional 最大值使用的最大不透明度
minOpacity Number 0.1 optional 最小值使用的最小不透明度
blur Number 0.85 optional 将应用于所有数据点的模糊因子, 模糊因子越高, 渐变越平滑
gradient Object optional 渐变色带设置,json对象,kv形式,key是数值,value是对应Color
min Number 数据最小值
max Number 数据最大值
data Array.<XYZ> 热力图数据,z值是value,xy是经纬度坐标,单位度
Returns:
热力图图层对象

staticYS.YSLayers.addIconsLayer(options)IconsLayer

添加图标图层
Name Type Description
options Object optional 对象有下面这些属性:
Name Type Default Description
id string 唯一标识
name string optional 名称
category string optional 图层分组
visible Boolean true optional 是否可见
openMouseHover Boolean false optional 是否开启鼠标移动事件
isAddTree Boolean true optional 是否添加到图层树上
treeIcon String optional 图层树上显示的图标,默认不显示
maxHeight number optional 最大显示距离
minHeight number optional 最小显示距离
Returns:
IconsLayer

staticYS.YSLayers.addImageLayer(options)ImageLayer

添加ImageLayer图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id string 唯一标识
url String 影像url地址
name String 图层名称
fileExtension String 切片文件扩展名
numberOfLevelZeroTilesX Number 0级切片X轴方向切片的数量
numberOfLevelZeroTilesY Number 0级切片Y轴方向切片的数量
minimumLevel Number 起始级别
maximumLevel Number 最大级别
insertPosition Number optional 添加的位置,默认添加到最后,即叠加到最上层
rectangle Rectangle 切片图层地理范围 {west: -180,south: -90,east: 180,north: 90}
category String 图层分类名称
isAddTree Boolean true optional 是否添加到图层树上
treeIcon String optional 图层树上显示的图标,默认不显示
isQuery Boolean true optional 是否支持空间查询
visible Boolean true optional 是否可见
Returns:
ImageLayer 对象

staticYS.YSLayers.addiTelluroLayer(options, global)iTelluroLayer

添加iTelluroServer的gis图层或dom图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id String optional 唯一标识
name String optional 名称
rectangle Rectangle optional 范围{west, south, east, north}
category String optional 图层分组
url String iTelluro.Server服务地址,如http://itelluroyun.infoearth.com:8038/iTelluro.Server/Service/GIS/gis.ashx
dsKey String iTelluro.Server数据服务的key
fileExtension String jpg optional 文件类型,jpg/png/bmp,默认jpg
zeroSpan Number 36.0 optional 0级切片跨度
levels Number 总级数
insertPosition Number optional 添加的位置,默认添加到最后,即叠加到最上层
isAddTree Boolean true optional 是否在图层树上显示
treeIcon String optional 图层树上显示的图标,默认不显示
isQuery Boolean false optional 是否支持空间查询
visible Boolean optional 是否可见
global Object 三维球对象(YouScene.earth)
Returns:
iTelluroLayer 对象

staticYS.YSLayers.addiTelluroLayerBil(options, global)iTelluroLayer

添加iTelluroServer的 BIL地形影像图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id String optional 唯一标识
name String optional 名称
rectangle Rectangle optional 范围{west, south, east, north}
category String optional 图层分组
url String iTelluro.Server服务地址,如http://itelluroyun.infoearth.com:8038/iTelluro.Server/Service/GIS/gis.ashx
dsKey String iTelluro.Server数据服务的key
colorRange String [] optional 高度颜色插值数组
zeroSpan Number 36.0 optional 0级切片跨度
levels Number 总级数
insertPosition Number optional 添加的位置,默认添加到最后,即叠加到最上层
isAddTree Boolean true optional 是否在图层树上显示
treeIcon String optional 图层树上显示的图标,默认不显示
isQuery Boolean false optional 是否支持空间查询
visible Boolean optional 是否可见
global Object 三维球对象(YouScene.earth)
Returns:
iTelluroLayer 对象

staticYS.YSLayers.addiTelluroPointCloudLayer(options)iTelluroPointCloudLayer

添加iTelluro点云场景数据
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id string 唯一标识
name String 图层名称
key String iTelluro.Server数据服务key
root String iTelluro.Server根地址,如http://fly.cigem.cn/
category String optional 图层分类
isAddTree Boolean true optional 是否添加到图层树
treeIcon String optional 图层树上显示的图标,默认不显示
visible Boolean true optional 是否可见
Returns:
iTelluroPointCloudLayer

staticYS.YSLayers.addiTelluroSceneLayer(options)iTelluroSceneLayer

添加iTelluro场景数据
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id string 唯一标识
name String 图层名称
key String iTelluro.Server数据服务key
root String iTelluro.Server根地址,如http://fly.cigem.cn/
category String optional 图层分类
isAddTree Boolean true optional 是否添加到图层树
treeIcon String optional 图层树上显示的图标,默认不显示
visible Boolean true optional 是否可见
Returns:
iTelluroSceneLayer

staticYS.YSLayers.addLabelLayer(options)LabelLayer

添加注记图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Description
id String optional 唯一标识
name String optional 名称
isAddTree Boolean optional 是否加入图层树
treeIcon String optional 图层树上显示的图标,默认不显示
minHeight Number optional 最小显示距离
maxHeight Number optional 最大显示距离
fontFamily Font optional 字体
fontSize Number optional 字体大小
color Color optional 字体颜色
haloColor Color optional 文字描边颜色,使用null将不添加描边
iconUrl String optional 图标url
visible Boolean optional 是否可见
Returns:
LabelLayer

staticYS.YSLayers.addLinesLayer(options)LinesLayer

添加线图层
Name Type Description
options Object optional 对象有下面这些属性:
Name Type Default Description
id String 唯一标识
name String optional 名称
isAddTree Boolean optional 是否加入树
treeIcon String optional 图层树上显示的图标,默认不显示
category String optional 图层分组
visible Boolean true optional 是否可见
Returns:
LinesLayer

staticYS.YSLayers.addLodSceneLayer(options)LodSceneLayer

添加一般场景数据
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id string 唯一标识
name String 图层名称
category String 图层分类
isAddTree Boolean true optional 是否添加到图层树
treeIcon String optional 图层树上显示的图标,默认不显示
visible Boolean true optional 是否可见
Returns:
LodSceneLayer

staticYS.YSLayers.addModelLayer(options)ModelLayer

添加模型图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Description
id String optional 唯一标识
name String optional 名称
isAddTree Boolean optional 是否加入树
treeIcon String optional 图层树上显示的图标,默认不显示
category String optional 图层分组
visible Boolean optional 是否可见
Returns:

staticYS.YSLayers.addPipeLineLayer(options)PipeLineLayer

添加管道图层
Name Type Description
options Object optional 对象有下面这些属性:
Name Type Default Description
id String 唯一标识
name String optional 名称
isAddTree Boolean optional 是否加入树
treeIcon String optional 图层树上显示的图标,默认不显示
category String optional 图层分组
visible Boolean true optional 是否可见
Returns:
PipeLineLayer

staticYS.YSLayers.addPointCloudLayer(options)PointCloudLayer

添加点云数据
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id string 唯一标识
name String 图层名称
category String 图层分类
isAddTree Boolean true optional 是否添加到图层树
treeIcon String optional 图层树上显示的图标,默认不显示
visible Boolean true optional 是否可见
Returns:
PointCloudLayer

staticYS.YSLayers.addPointLayer(options)PointLayer

添加图形点图层(只带颜色和大小的小圆点)
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id String optional 唯一标识
name String optional 名称
category String optional 图层分组
visible Boolean true optional 是否可见
isAddTree Boolean true optional 是否添加到图层树上
treeIcon String optional 图层树上显示的图标,默认不显示
Returns:
PointLayer

staticYS.YSLayers.addPolygonLayer(options)PolygonLayer

添加多边形面图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Description
id String optional 唯一标识
name String optional 名称
isAddTree Boolean optional 是否加入树
treeIcon String optional 图层树上显示的图标,默认不显示
category String optional 图层分组
maxDisplayAltitude Number optional 最大显示距离
minDisplayAltitude Number optional 最小显示距离
visible Boolean optional 是否可见
Returns:
PolygonLayer

staticYS.YSLayers.addSingleTileImageLayer(options)SingleTileImageLayer

添加SingleTileImageLayer图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id string optional 唯一标识
url String optional 自定义图片地址
name String optional 图层名称
insertPosition Number optional 添加的位置,默认添加到最后,即叠加到最上层
rectangle Object optional 切片图层地理范围 {west: -180,south: -90,east: 180,north: 90}
category String optional 图层分类名称
isAddTree Boolean false optional 是否添加到图层树上
treeIcon String optional 图层树上显示的图标,默认不显示
visible Boolean true optional 是否可见
Returns:
SingleTileImageLayer 对象

staticYS.YSLayers.addTDTLayer(options)TDTLayer

添加天地图图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id String optional 唯一标识
name String optional 名称
layer TDTLayerType | String 请求图层Key
minimumLevel Number optional 最小级数(默认为该图层的最小级数)
maximumLevel Number optional 最大级数(默认为该图层的最大级数)
insertPosition Number optional 添加的位置,默认添加到最后,即叠加到最上层
rectangle Object optional 切片图层地理范围 {west: -180,south: -90,east: 180,north: 90}
category String optional 图层分类名称
isAddTree Boolean false optional 是否添加到图层树上
treeIcon String optional 图层树上显示的图标,默认不显示
visible Boolean true optional 是否可见
token String 天地图的应用开发token
Returns:
TDTLayer 对象

staticYS.YSLayers.addTerrainLayer(options)TerrainLayer

添加DEM数据
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id String 图层id
name String 图层名称
url String iTelluro.Server发布的DEM的url
maxLevel Number 最大级别
scale Number 1 optional 高程夸张
visible Boolean true optional 是否可见
isAddTree Boolean true optional 是否在图层树上显示
treeIcon String optional 图层树上显示的图标,默认不显示
rectangle Object 图层地理范围 {west: -180,south: -90,east: 180,north: 90}
Returns:
TerrainLayer

staticYS.YSLayers.addVectorTileLayer(options)VectorTileLayer

添加矢量切片图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id String optional 唯一标识
name String optional 名称
category String optional 图层分组
isAddTree Boolean optional 是否在图层树上显示
treeIcon String optional 图层树上显示的图标,默认不显示
visible Boolean optional 是否可见
url String optional 数据url,支持小数据量的geojson、shape文件矢量动态切片
defaultStyle Object optional 样式集合
mininumLevel Number 3 optional 最小级别
maxinumLevel Number 22 optional 最大级别
simplifly Boolean optional true则简化,默认不简化
Returns:
矢量切片图层对象

staticYS.YSLayers.addVideoLayer(options)VideoLayer

添加视频体图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id String optional 唯一标识
name String optional 名称
isAddTree Boolean optional 是否加入树
treeIcon String optional 图层树上显示的图标,默认不显示
category String optional 图层分组
maxDisplayAltitude Number optional 最大显示距离
minDisplayAltitude Number optional 最小显示距离
visible Boolean true optional 是否可见
Returns:
VideoLayer

staticYS.YSLayers.addWallLayer(options)WallLayer

添加墙图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Description
id String optional 唯一标识
name String optional 名称
isAddTree Boolean optional 是否加入树
treeIcon String optional 图层树上显示的图标,默认不显示
category String optional 图层分组
visible Boolean optional 是否可见
Returns:
WallLayer

staticYS.YSLayers.addWMSLayer(options)WMSLayer

添加WMSLayer图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id string optional 唯一标识
url String WMS服务url
layers String 请求图层Key
name String optional 图层名称
tileWidth Number 256 optional 切片宽度
tileHeitht Number 256 optional 切片高度
minimumLevel Number 0 optional 最小级数
maximumLevel Number optional 最大级数
transparent Boolean optional 是否透明
insertPosition Number optional 添加的位置,默认添加到最后,即叠加到最上层
rectangle Rectangle optional 切片图层地理范围 {west: -180,south: -90,east: 180,north: 90}
category String optional 图层分类名称
isAddTree Boolean false optional 是否添加到图层树上
treeIcon String optional 图层树上显示的图标,默认不显示
isQuery Boolean false optional 是否支持空间查询
visible Boolean true optional 是否可见
Returns:
WMSLayer 对象

staticYS.YSLayers.addWMTSLayer(options)WMTSLayer

添加WMTSLayer图层
Name Type Description
options Object 对象有下面这些属性:
Name Type Default Description
id string optional 唯一标识
url String WMTS服务url
layer String 请求图层Key
name String optional 图层名称
style String "default" optional 请求样式
format String "image/jpeg" optional 图片格式
tileMatrixSetID String 切片方式
tileMatrixLabels Array.<String> optional 标识符列表
isGeoCoordSystem Boolean true optional 是否是地理坐标系
tileWidth Number 256 optional 切片宽度
tileHeitht Number 256 optional 切片高度
minimumLevel Number 0 optional 最小级数
maximumLevel Number optional 最大级数
insertPosition Number optional 添加的位置,默认添加到最后,即叠加到最上层
rectangle Rectangle optional 切片图层地理范围 {west: -180,south: -90,east: 180,north: 90}
category String optional 图层分类名称
isAddTree Boolean false optional 是否添加到图层树上
treeIcon String optional 图层树上显示的图标,默认不显示
isQuery Boolean false optional 是否支持空间查询
visible Boolean true optional 是否可见
Returns:
WMTSLayer 对象

staticYS.YSLayers.findAllIconsLayers()Array.<IconsLayer>

查找所有的IconsLayer
Returns:
返回所有IconsLayer对象

staticYS.YSLayers.findAllImageLayers()Array.<ImageLayer>

查找所有的ImageLayer(如果要获取当前已经加载的图层的总层级, 应该用这个方法获取到的个数+1, 因为球初始化默认加载了一张图片,也算一层)
Returns:
返回所有ImageLayer对象

staticYS.YSLayers.findAllLabelLayers()Array.<LabelLayer>

查找所有的LabelLayer
Returns:
返回所有LabelLayer对象

staticYS.YSLayers.findAllLinesLayers()Array.<LinesLayer>

查找所有的LinesLayer
Returns:
返回所有LinesLayer对象

staticYS.YSLayers.findAllPolygonLayers()Array.<PolygonLayer>

查找所有的PolygonLayer
Returns:
返回所有PolygonLayer对象

staticYS.YSLayers.findLayerById(key)AbstractLayer

通过key查找图层或者场景或者线或者点
Name Type Description
key String 需要查找的key
Returns:
返回图层对象

staticYS.YSLayers.findLayerByType(type)Array.<AbstractLayer>

通过LayerType查找类型的图层
Name Type Description
type LayerType 需要查找的类型 枚举LayerType
Returns:
返回所有属于type类型的图层

staticYS.YSLayers.removeLayer(layer)

删除一个图层对象
Name Type Description
layer AbstractLayer 需要删除的图层对象
Fires:
Returns:
undefined;

staticYS.YSLayers.removeLayerByKey(key)

通过key删除一个图层对象
Name Type Description
key String 需要删除的图层对象key
Fires:
Returns:
undefined;