CoordinateConversionViewModel

属性概述

属性详细信息

conversions Collection<Conversion>

包含微件当前显示的每个 Conversion 的集合。

示例

// conversions can be set with an array of strings where each string is a format's name
coordinateConversion.conversions = ["mgrs"];

currentLocation Point

将微件当前显示的坐标位置描述为一个点。设置此属性将更新所有转换。

declaredClass Stringreadonly inherited

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

formats Collection<Format>

包含微件能够显示的每种format的集合。

默认格式是 basemap、dd、ddm、dms、mgrs、usng、utm 和 xy。

goToOverride GoToOverride

起始版本：GeoScene Maps SDK for JavaScript 4.8

此函数提供了覆盖 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);
};

locationSymbol SimpleMarkerSymbol|PictureMarkerSymbol

当 capture 模式处于活动状态时，此符号可用于可视化微件当前描述的位置。

mode String

描述微件的当前模式。

• 在 live 模式下，微件将随光标的移动而更新。
• 在 capture 模式下，微件将在鼠标单击时更新并显示标记当前位置的图形。

可能值："live"|"capture"

默认值：live

state Stringreadonly

视图模型的状态。

可能值："ready"|"loading"|"disabled"

默认值：disabled

storageEnabled Boolean

起始版本：GeoScene Maps SDK for JavaScript 4.20

如果此属性设置为 true，则 sessionStorage 或 localStorage (取决于 storageType) 将用于混合和持久化 CoordinateConversion 微件的状态。

默认值：true

storageType String

起始版本：GeoScene Maps SDK for JavaScript 4.23

此属性确定是使用 sessionStorage 还是 localStorage 来存储微件状态。

可能值："session"|"local"

默认值："session"

另请参阅

• Window.sessionStorage

• Window.localStorage

view MapView|SceneView

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

convert(point, format){Promise<Position>}

尝试将点转换为 Position。

参数

point Point 要转换的点。

format Format 描述点应如何转换的格式。

返回

类型	描述
Promise<Position>	解析后，返回 Position。

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

reverseConvert(coordinate, format){Promise<Point>}

尝试将字符串转换为点。必须指定字符串的格式。可以从 formats 属性中获取可用格式的集合。

参数

coordinate String 坐标字符串。

format Format 指定输入坐标的格式。

返回

类型	描述
Promise<Point>	解析后，返回点。

updateConversions(conversions, location){Promise<Conversion[]>}

根据输入点更新输入转换。

参数

conversions Conversion[] 要更新的 Conversions 数组。

location Point 将用于更新每个输入转换的点。

返回

类型	描述
Promise<Conversion[]>	解析后，返回具有更新 Positions 的 Conversions 数组。

类型定义

Position

使用位置、点、坐标和字符串来描述一个点。

属性

location Point 点几何，表示转换所描述的位置。

coordinate String 表示位置的字符串。