AreaMeasurement3DViewModel

属性概述

属性详细信息

analysis AreaMeasurementAnalysisautocastreadonly

起始版本：GeoScene Maps SDK for JavaScript 4.23

由视图模型创建或修改的面积测量分析对象。

可以在视图模型构建期间设置此属性，以向视图模型提供现有分析以进行修改。一旦分配给视图模型，分析上的属性也可进行更新。

如果在视图模型构建期间未提供分析，则视图模型会自动创建其自己的分析并将其添加到视图中。在这种情况下，当视图模型被销毁时，分析也将自动从视图中移除。

示例

// Construct an area measurement analysis object outside of the view model
const analysis = new AreaMeasurementAnalysis({
  geometry: {
    type: "polygon", // autocasts as new Polygon()
    rings: [
      [-73.9817, 40.7681],
      [-73.9582, 40.8005],
      [-73.9495, 40.7968],
      [-73.9730, 40.7644],
      [-73.9817, 40.7681]
    ]
  }
});

// Ensure that the analysis is added to the view
view.analyses.add(analysis);

// Frame the analysis in the view
view.goTo(analysis.extent);

// Pass the analysis object as a constructor parameter to modify it using the view model
const viewModel = new AreaMeasurement3DViewModel({
  analysis: analysis,
  view: view
});

declaredClass Stringreadonly inherited

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

measurement Objectreadonly

该区域的当前测量值。

属性

mode String 描述进行测量的模式。在 euclidean 模式中，面积和周长是根据 ECEF 坐标系中周长为直线段的平面多边形计算的。在 geodesic 模式下，面积和周长是根据 WGS84 椭球上的测地线多边形计算的。 可能值："euclidean"|"geodesic"

area MeasurementValue 多边形的面积。

perimeterLength MeasurementValue 多边形的周长。

state Stringreadonly

视图模型的状态。

值	描述
disabled	尚未准备就绪
ready	准备测量
measuring	目前正在测量
measured	测量已完成

可能值："disabled"|"ready"|"measuring"|"measured"

默认值：disabled

unit SystemOrAreaUnit

单位系统（英制、公制）或显示面积值的特定单位。可能值在 unitOptions 中列出。

unitOptions SystemOrAreaUnit[]

用于显示面积值的可用单位列表和单位系统 (英制、公制)。默认情况下，包括以下单位：metric、imperial、square-inches、square-feet、square-us-feet、square-yards、square-miles、square-meters、square-kilometers、acres、ares、hectares。可能的 unit 值只能是此列表的子集。

view SceneView

微件将从中操作的视图。

方法概述

方法详细说明

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() 进行删除。如果未提供键，则句柄将被添加到默认组。

clear()

起始版本：GeoScene Maps SDK for JavaScript 4.16

清除当前测量。

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");

start()

起始版本：GeoScene Maps SDK for JavaScript 4.16

开始新的测量。

示例

const areaMeasurement3DViewModel = new AreaMeasurement3DViewModel({
  view: view,
  unit: "square-meters"
});

await areaMeasurement3DViewModel.start();

类型定义

MeasurementValue Object

测量值。

属性

text String 测量值的文本表示。

state String 测量值的状态。 值 描述 available 测量值可用 unavailable 由于测量不完整，则测量值不可用 invalid 由于无效的测量配置 (例如，自相交面)，则测量值不可用