ViewshedAnalysis

可视域分析空间分析对象，用于对三维场景实现可视域分析。

构造函数

import { ViewshedAnalysis } from '@maptalks/gl-layers';

const viewshedAnalysis = new ViewshedAnalysis({
  eyePos: [121, 39, 100],
  lookPoint: [121, 39, 0],
  verticalAngle: 90,
  horizontalAngle: 90,
  visibleColor: [0.0, 1.0, 0.0, 1.0],
  invisibleColor: [1.0, 0.0, 0.0, 1.0]
});

viewshedAnalysis.addTo(groupGLLayer);

详细信息

参数：

• options* Object 配置参数，可选的配置项如下：

配置名	类型	描述	默认值
eyePos*	Number[]	观察者位置，[x, y, h]，x和y是经纬度，h是海拔高度	null
lookPoint*	Number[]	观察目标位置，[x, y, h]，x和y是经纬度，h是海拔高度	null
verticalAngle	Number	垂直视角，单位角度	90
horizontalAngle	Number	水平视角，单位角度	90
visibleColor	Number[]	四位归一化数组，可视区域颜色	[0, 1, 0, 0.3]
invisibleColor	Number[]	四位归一化数组，不可视区域颜色	[1, 0, 0, 0.3]

注：visibleColor / invisibleColor 的默认透明度已在新版本中调整为 0.3（2026 源码 renderAnalysis 默认值 [0.0, 1.0, 0.0, 0.3] / [1.0, 0.0, 0.0, 0.3]，2026 核对）。

成员方法

getVertexCoordinates()

获取viewshed棱锥的4个顶点的坐标（2026 源码核对补充）。

返回：

• Array

继承自Analysis的方法

addTo(groupGLLayer)

添加到GroupGLLayer上。

空间分析对象只支持添加到GroupGLLayer上，无法添加到其他WebGL图层。

参数：

• groupGLLayer GroupGLLayer GroupGLLayer图层

返回：

• this

remove()

从图层上移除空间分析对象。

返回：

• void

update(name, value)

更新options数据。

参数：

• name String 设置名称
• value any 设置的值

返回：

• void

getAnalysisType()

获取Analysis的类型。

返回：

• String

getDefines()

内部调用方法。

返回Analysis绘制时在shader中添加的defines。

返回：

• Object

renderAnalysis(meshes)

内部调用方法。

绘制空间分析场景（各分析子类实现），返回渲染所需的 uniform 变量。

参数：

• meshes Mesh[] 场景网格

返回：

• Object

enable()

启用分析。

返回：

• void

disable()

禁用分析。

返回：

• void

isEnable()

分析是否已启用。

返回：

• Boolean

getExcludeLayers()

获取分析时排除的图层id列表（分析时忽略这些图层）。

返回：

• String[]

setExcludeLayers(layerIds)

设置分析时排除的图层id列表。

参数：

• layerIds String[] 图层id列表

返回：

• void

exportAnalysisMap(meshes)

导出分析结果图（RGBA像素数据），分析未启用时返回 null。

参数：

• meshes Mesh[] 场景网格

返回：

• Uint8Array

本文档已与 @maptalks/gl-layers 2026 源码核对（api-notes-others.md / api-notes-vt-gl.md）