DirectLineMeasurementAnalysis 可计算两点之间的距离并在 3D SceneView 中显示测量值。
要显示两点之间的距离测量值，请创建 DirectLineMeasurementAnalysis 的新实例，将其添加到 SceneView.analyses 并设置 startPoint 和 endPoint 属性。
使用 DirectLineMeasurementAnalysisView3D 检索分析结果。
// create analysis
const directLineMeasurement = new DirectLineMeasurementAnalysis({
startPoint: pointA,
endPoint: pointB,
unit: "imperial"
});
// add to the scene view
sceneView.analyses.add(directLineMeasurement);
// retrieve measured results from analysis view
const analysisView = await sceneView.whenAnalysisView(directLineMeasurement);
await reactiveUtils.whenOnce(() => !analysisView.updating);
const result = analysisView.result;
DirectLineMeasurementAnalysis 上的 StartPoint 和 endPoint 只能以编程方式设置。但是，结合 SceneView.hitTest 或 SketchViewModel，此分析可用于为最终用户创建交互式体验。
使用 DirectLineMeasurement3D 微件以添加交互性并允许用户更改分析的几何形状。
已知限制
此分析仅在 3D SceneView 中受支持。
构造函数
属性概述
| 名称 | 类型 | 描述 | 类 |
|---|---|---|---|
| String | 类的名称。 更多详情 | Accessor | |
| Point | 测量的终点。 更多详情 | DirectLineMeasurementAnalysis | |
| Point | 测量的起点。 更多详情 | DirectLineMeasurementAnalysis | |
| SystemOrLengthUnit | 单位系统（英制、公制）或用于计算距离的特定单位。 更多详情 | DirectLineMeasurementAnalysis |
属性详细信息
-
类的名称。声明的类名称格式化为
geoscene.folder.className。
-
测量的终点。
如果该点具有 z-值，则将其视为绝对值，否则该点将与地面对齐。
-
测量的起点。
如果该点具有 z-值，则将其视为绝对值，否则该点将与地面对齐。
-
unit SystemOrLengthUnit
-
单位系统（英制、公制）或用于计算距离的特定单位。
方法概述
| 名称 | 返回值类值 | 描述 | 类 |
|---|---|---|---|
添加一个或多个与对象的生命周期相关联的句柄。 更多详情 | Accessor | ||
| this | 创建此对象的深度克隆。 更多详情 | DirectLineMeasurementAnalysis | |
| Boolean | 如果存在指定的句柄组，则返回 true。 更多详情 | Accessor | |
移除对象拥有的句柄组。 更多详情 | Accessor |
方法详细说明
-
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 调用此方法的类实例的深度克隆。
-
起始版本：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");