UtilityNetworkTraceViewModel

属性概述

属性详细信息

declaredClass Stringreadonly inherited

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

defaultGraphicColor GraphicColor

起始版本：GeoScene Maps SDK for JavaScript 4.23

用于指定追踪结果的聚合几何的默认颜色。

默认值：{ color: [255, 255, 0, 0.6], haloOpacity: 0.9, fillOpacity: 0.2, hex: "#FFFF00" }

flags FlagProperty[]

要加载到微件中以查找标志的地图点数组。

默认值：[]

示例

const unt = new UtilityNetworkTrace({
 view: view,
 showSelectionAttributes: true,
 selectOnComplete: true,
 showGraphicsOnComplete: true,
 selectedTraces: ["{E8D545B8-596D-4656-BF5E-16C1D7CBEC9B}"],
 flags: [
   {
     type: "starting-point",
     mapPoint: {
       spatialReference: { latestWkid: 3857, wkid: 102100 },
       x: -9814829.166046409,
       y: 5127094.1017433
     }
   },
   {
     type: "barrier",
     mapPoint: {
     spatialReference: { latestWkid: 3857, wkid: 102100 },
       x: -9814828.449441982,
       y: 5127089.085566963
     }
   }
 ]
});

gdbVersion String

要传递到追踪中的地理数据库版本。

默认值："sde.DEFAULT"

goToOverride GoToOverride

此函数提供了覆盖 MapView goTo() 或 SceneView goTo() 方法的能力。

另请参阅

• MapView
• SceneView

示例

// The following snippet uses the Search widget but can be applied to any
// widgets that support the goToOverride property.
search.goToOverride = function(view, goToParams) {
  goToParams.options.duration = updatedDuration;
  return view.goTo(goToParams.target, goToParams.options);
};

selectedTraces String[]

要在初始加载时选择的追踪的全局 Id 数组。

默认值：[]

selectOnComplete Boolean

如果为 true，则在追踪完成后在视图中选择公共设施网络元素。

默认值：true

showGraphicsOnComplete Boolean

如果为 true，则将图形图层添加到视图中，以便在追踪完成时高亮显示公共设施网络元素。

默认值：true

showSelectionAttributes Boolean

确定是否显示已完成追踪中所选要素的列表。

默认值：true

state Stringreadonly

视图模型的状态。

可能值："loading"|"ready"

默认值：ready

view MapView

微件将从中操作的视图。

方法概述

方法详细说明

addFlagByHit(type){Promise<boolean>}

如果要查询要素，则为视图上的单击事件添加标志点图形。

参数

type String 标志的类型可以是 "starting point" 或 "barrier"。

返回

类型	描述
Promise<boolean>	解析后，如果视图中存在要查询的要素，则响应为 true。

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

addResultGraphicToView(trace, color){Promise}

在视图的图形上为追踪返回的所有要素的聚合结果创建图形。

参数

trace TraceResultExtend 追踪配置设置的聚合以及该追踪的结果。

color GraphicColor 视图的图形中追踪结果的图形颜色。

返回

类型	描述
Promise	在将图形添加到视图时解析。

addTerminal(selectedTerminal, feature)

将所选终端添加到标志点。

参数

selectedTerminal String 所选终端的终端 id。

feature FlagProperty 用于分配终端的标志。

callTrace(){Promise<boolean>}

在执行追踪之前，获取所选的要运行的追踪类型的所有参数。

返回

类型	描述
Promise<boolean>	解析后，当追踪类型中的参数已加载时，响应是 true。

changeResultGraphicColor(color, trace)

更改追踪的聚合结果的图形颜色。

参数

color GraphicColor 视图的图形中追踪结果的图形颜色。

trace TraceResultExtend 追踪配置设置的聚合以及该追踪的结果。

checkCanTrace(){ValidSetup}

可用于验证是否满足执行追踪的所有要求 (至少选择了 1 个起点和至少 1 个追踪类型)。

返回

类型	描述
ValidSetup	表示追踪设置是否正确。

checkSelectionExist(){Boolean}

指示视图上是否存在任何选择。

返回

类型	描述
Boolean	如果视图上存在选定内容，则返回 true。

clearResult(trace)

从结果中移除特定追踪。这还将清除该追踪视图中的任何图形或选定内容。

参数

trace TraceItem 将清除的追踪。

executeTrace(traceItem, url, params){Promise<TraceResultExtend>}

执行追踪并将所有追踪结果作为图形和/或要素选择和函数返回。

参数

traceItem TraceItem 用于追踪的追踪项目输入。

url String 要追踪的服务的 URL。

params TraceParameters 追踪输入参数。

返回

类型	描述
Promise<TraceResultExtend>	表示追踪结果及其属性。

getValidSources(){Array<(EdgeSourceJSON|JunctionSourceJSON)>}

获取视图中属于公共设施网络的有效边和交汇点图层，这些图层可用于在视图中放置标志。

返回

类型	描述
Array<(EdgeSourceJSON|JunctionSourceJSON)>	边或交汇点图层信息。

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

loadUtilityNetwork(){Promise<UtilityNetwork>}

读取 web 地图并加载 UtilityNetwork (如果存在)。

返回

类型	描述
Promise<UtilityNetwork>	在加载 UtilityNetwork 时解析。

manageFilterBarrier(status, feature)

启用或禁用障碍标志上的过滤障碍设置。

参数

status Boolean 是否启用或禁用过滤障碍。

feature FlagProperty 为其启用或禁用过滤器障碍的障碍标志。

mergeSelection(status, trace)

用于在运行多个追踪时合并图层视图中的要素选择。

参数

status Boolean 如果为 true，则追踪选择结果是合并选择集的一部分。

trace TraceItem 为其定义状态的追踪。

queryFeaturesById(dataItems){Promise<FeatureSetInfo[]>}

按 ObjectID 查询图层，以获取追踪结果元素上不存在的多种属性。

参数

dataItems NetworkElement[] NetworkElements 的数组。

返回

类型	描述
Promise<FeatureSetInfo[]>	解析后，将返回 FeatureSetInfo 数组。

queryFlagByHitTest(e, flagType){Promise<boolean>}

获取命中测试的结果以查找资产，以便为追踪创建标志。

参数

e ClickEvent 单击事件。

flagType String 标志的类型。它必须为 "starting point" 或 "barrier"。

返回

类型	描述
Promise<boolean>	解析后，对于成功的 hitTest，返回 true。

removeFlag(flag)

从视图中移除选定的标志。

参数

flag FlagProperty 用于标识要移除的标志的 FlagProperty。

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

removeResultGraphicFromView(trace)

从视图的图形中移除特定的追踪结果图形。

参数

trace TraceResultExtend 将移除图形的追踪。

removeSelection()

从图层视图中移除所选内容。

removeTerminal(selectedTerminal, feature)

从标志中移除选定的终端。

参数

selectedTerminal String 所选终端的终端 id。

feature FlagProperty 用于移除终端的标志。

reset()

清除视图中的所有输入 (标志、追踪类型) 和所有结果 (选择、图形)。

selectFeaturesById(resultSet)

基于 ObjectID 列表对图层视图执行选择。

参数

resultSet NetworkElement[] NetworkElements 的数组。

selectResults(resultSet)

遍历追踪结果元素以按网络源 id 对其进行分组，并在图层视图中选择它们。

参数

resultSet NetworkElement[] NetworkElements 的数组。

selectTraces(state, traceId)

设置要从 WebMap 的可用追踪配置中运行的追踪类型。

参数

state Boolean 如果选择了追踪，则为 true。

traceId String 追踪配置的 globalid。

selectTracesOnLoad()

预设置在加载微件时从 WebMap 的可用追踪配置中运行的追踪类型。

zoomToAsset(geometry)

缩放至视图中标志的要素或结果要素。

参数

geometry GoToTarget2D|GoToTarget3D 要缩放到的几何。

类型定义

AssetGroupJSON Object

AssetGroupJSON 表示资产组。资产组是子类型字段，表示公共设施网络类的主要分类。

属性

assetGroupCode Number 资产组代码。

assetGroupName String 资产组名称。

assetTypes AssetTypeJSON[] 资产类型。

AssetTypeJSON Object

AssetTypeJSON 表示资产类型。属性域在每个网络类的子类型级别的资产类型字段上分配。它表示公共设施网络类的次要分类。

属性

assetTypeCode Number 资产类型代码。

assetTypeName String 资产类型名称。

terminalConfigurationId Number 终端配置的 id。

DisplayField Object

DisplayField 表示用作显示标记要素和所选要素标注的属性字段。

属性

field String 要素的显示字段。

value String 字段的值。

EdgeSourceJSON Object

EdgeSourceJSON 表示参与公共设施网络服务的线图层。

属性

layerId Number 线图层的图层 id。

assetGroups AssetGroupJSON[] 线图层的资产组属性值。

sourceId Number 线图层的网络源 id。

FeatureSetInfo Object

FeatureSetInfo 表示要素集中结果的信息。

属性

layer FeatureLayer 数据集的 FeatureLayer。

featureSet FeatureSet 要素集。

FlagProperty Object

FlagProperty 表示用于定义每个标志点（起点和障碍）的属性。

属性

allTerminals TerminalConfiguration 可用的终端，用于根据终端配置定义允许的路径。始终设置默认终端。

details any hitTest 返回的所有信息。

displayField DisplayField 标志的显示字段。

id Number 标志的 id。

mapGraphic Graphic 标志图形。

mapPoint Point 标志的几何点。

selectedTerminals Number[] 为标志选择的终端（可以是最终用户选择的一个或多个默认终端）。

type String 正在设置的标志类型。必须为 "starting point" 或 "barrier"。 可能值 值 描述 starting-point 标志集将是追踪的起始位置。 barrier 标志集将标记停止追踪的位置。

GraphicColor Object

GraphicColor 表示图形图层中追踪结果图形的颜色。

属性

color Number[] 视图中追踪结果图形的颜色。

haloOpacity Number 图形符号的光晕的不透明度。

hex String 颜色选取器中追踪结果图形的颜色。

JunctionSourceJSON Object

JunctionSourceJSON 表示参与公共设施网络服务的点图层。

属性

layerId Number 点图层的图层 id。

assetGroups AssetGroupJSON[] 点图层的资产组属性值。

sourceId Number 点图层的网络源 id。

TraceItem Object

TraceItem 扩展了命名的追踪配置，并添加了一个属性来管理视图上的选择。

属性

selected Boolean 如果视图上有用于追踪的选定内容，则返回 true。

TraceResultExtend Object

TraceResultExtend 根据追踪配置和追踪结果来组织结果。

属性

TraceItem TraceItem TraceItem 扩展了命名的追踪配置，并添加了一个属性来管理视图上的选择。

TraceResult TraceResult 从追踪返回的结果的集合。

selectionEnabled Boolean 如果启用了选择，则返回 true。

graphicEnabled Boolean 如果启用了图形，则返回 true。

graphicColor GraphicColor 图形图层中追踪结果的图形颜色。

status String 要从服务器返回错误的追踪的当前状态。

ValidSetup Object

ValidSetup 在追踪可以执行之前验证追踪是否满足所有要求。

属性

status Boolean 如果满足要求，则为 true。

issues String[] 缺少要求的错误消息数组。