LineOfSightAnalysisObserver

属性概述

属性详细信息

declaredClass Stringreadonly inherited

类的名称。声明的类名称格式化为 geoscene.folder.className。

elevationInfo Object

指定观测点在垂直轴 (z) 上的放置方式。有关如何使用该属性的示例，请参阅 ElevationInfo 示例。

属性

mode String 定义观测点相对于地形表面或场景中 3D 对象的放置方式。有关可能值列表，请参见下表。 模式 描述 on-the-ground 观测点与 Ground 对齐。如果场景包含 IntegratedMeshLayer，则要素将与 IntegratedMeshLayer 对齐。如果要素具有 z 值，则在此模式下会忽略 z 值。带有 2D 符号的要素叠加在 Ground 或 IntegratedMeshLayer 上。这是没有 z 值的图层的默认模式，其中包含使用 ObjectSymbol3DLayer 渲染的 Polyline、Polygon 要素或 Point 要素。 absolute-height 观测点放置在海平面以上的绝对高程 (z 值) 处。此 z 值由几何的 z 值 (如果存在) 确定。如果定义了 featureExpressionInfo，则使用表达式的结果而不是几何的 z 值。此模式不考虑使用 Ground 或任何其他图层的高程。当观测点位置 hasZ 为 true 时，这是默认值。 relative-to-ground 观测点放置在相对于 Ground 或 IntegratedMeshLayer 的高度上。高程由 Ground 或 IntegratedMeshLayer 的高程和几何 z 值 (如果存在) 的总和确定。如果定义了 featureExpressionInfo，则使用表达式的结果而不是观测点的 z 值。如果观测点没有 z 值，则 relative-to-ground 是使用 IconSymbol3DLayers 渲染的 Point 几何的默认值。 relative-to-scene 观测点与拉伸多边形、3D Object SceneLayers 或 BuildingSceneLayers 对齐，具体取决于哪个高程更高。如果要素不在建筑物或任何其他要素的正上方，则将其与 Ground 或 IntegratedMeshLayer 的高程对齐。如果存在，则将观测点的 z 值添加到高程中。如果定义了 featureExpressionInfo，则使用表达式的结果而不是几何的 z 值。 可能值："on-the-ground"|"relative-to-ground"|"absolute-height"|"relative-to-scene"

offset Number optional 添加到观测点垂直位置的高程偏移。如果未定义 unit，则偏移量以 meters 为单位。当 mode = "on-the-ground" 时，则此属性无效。

feature Graphic

指定应从交叉测试中排除的要素。在场景几何上放置视线位置时使用此选项。由于细节级别的原因，场景几何可能会发生变化，从而导致分析结果不稳定。通过指定要从交叉测试中排除的要素，可以避免此问题。

请注意，您可分配客户端图形，这些图形将被相应地考虑在内。然而，有关客户端图形的信息将不会持久化，并在反序列化后产生空的引用。

position Pointautocast

Point 表示观察者的位置。一旦设置了位置，新视线分析将同步计算相交以及对关联 LineOfSightAnalysis 的每个目标的可见性。

方法概述

方法详细说明

addHandles(handleOrHandles, groupKey)inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

添加一个或多个与对象的生命周期相关联的句柄。当对象被销毁时，将移除句柄。

// Manually manage handles
const handle = reactiveUtils.when(
  () => !view.updating,
  () => {
    wkidSelect.disabled = false;
  },
  { once: true }
);

// Handle gets removed when the object is destroyed.
this.addHandles(handle);

参数

handleOrHandles WatchHandle|WatchHandle[] 对象销毁后，标记为要移除的句柄。

groupKey * optional 标识句柄应添加到的组的键。组中的所有句柄稍后都可使用 Accessor.removeHandles() 进行删除。如果未提供键，则句柄将被添加到默认组。

clone(){this}

创建此对象的深度克隆。任何通过引用存储值的属性都将被分配克隆实例上引用值的副本。

返回

类型	描述
this	调用此方法的类实例的深度克隆。

hasHandles(groupKey){Boolean}inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

如果存在指定的句柄组，则返回 true。

参数

groupKey * optional 组键。

返回

类型	描述
Boolean	如果存在指定的句柄组，则返回 true。

示例

// Remove a named group of handles if they exist.
if (obj.hasHandles("watch-view-updates")) {
  obj.removeHandles("watch-view-updates");
}

removeHandles(groupKey)inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

移除对象拥有的句柄组。

参数

groupKey * optional 要移除的组键或组键的数组或集合。

示例

obj.removeHandles(); // removes handles from default group

obj.removeHandles("handle-group");
obj.removeHandles("other-handle-group");