TileInfo

属性概述

属性详细信息

declaredClass Stringreadonly inherited

起始版本：GeoScene Maps SDK for JavaScript 4.7

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

dpi Number

切片方案的每英寸点数 (DPI)。如果选择的 DPI 与输出设备的分辨率不匹配，则地图切片的比例将不正确。默认值为 96。

默认值：96

format String

缓存切片的图像格式。

可能值："png"|"png24"|"png32"|"jpg"|"dib"|"tiff"|"emf"|"ps"|"pdf"|"gif"|"svg"|"svgz"|"mixed"|"lerc"|"pbf"

isWrappable Boolean

起始版本：GeoScene Maps SDK for JavaScript 4.5

指示切片方案是否支持环绕。

lods LOD[]autocast

自动转换自 Object[]

定义切片方案的细节级别数组。

origin Pointautocast

切片方案原点。切片方案的左上角，以源数据的空间参考坐标表示。

size Number[]

切片大小，以像素为单位。

示例

// sets the height and width of each tile to [ 256, 256 ]
tileInfo.size = 256;

spatialReference SpatialReferenceautocast

切片方案的空间参考。

方法概述

方法详细说明

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

create(options){TileInfo}static

一种便捷方法，用于创建具有预设属性 (如 LODs) 的新 TileInfo 实例。可选地，还可设置诸如 size、scales[] 和 SpatialReference 等属性来计算每个 TileInfo 的 LODs。当提供的默认 LOD 数量不足时，这很有用。例如，如果要将视图的比例设置为 1:1，则必须创建其他 LOD。以下示例代码段中提供了设置此比例和创建其他 LOD 的示例。

参数

规范

options Object optional 一个对象，其中包含用于计算新 TileInfo 实例的大小、比例和 SpatialReference。 规范 size Number optional 默认值：256 每个切片的大小，以像素为单位。 numLODs Number optional 默认值：24 要创建的 LOD 总数。 spatialReference SpatialReference optional 默认值：WebMercator 新 TileInfo 实例的空间参考。如果空间参考不是 WGS84 或 WebMercator，则 TileInfo 的原点为 0.0。 scales Number[] optional 默认值：GeoScene Online 底图提供的比例 要用于 TileInfo 的比例值数组。如果未指定任何比例，则使用的 GeoScene Online 底图中的比例将在级别 0 到 24 之间。

返回

类型	描述
TileInfo	新的 TileInfo 实例。比例决定了要创建的 LODs。DPI 默认为 96，当前无法修改。

另请参阅

• MapView.constraints

示例

// This snippet shows how to create a TileInfo instance using the default
// settings and passing its resulting LODs to a MapView's constraints

let view = new MapView({
  container: "viewDiv",
  map: map,
  constraints: {
    lods: TileInfo.create().lods
  }
});

// This snippet shows how to set the MapView scale 1:1 while generating additional LODs for the MapView.constraints.
const spatialReference = new SpatialReference({
  wkid: 2154
});

const center = new Point({
  x: 0,
  y: 0,
  spatialReference
});

// Create LODs from level 0 to 31
const tileInfo = TileInfo.create({
  spatialReference,
  numLODs: 32
});

const lods = tileInfo.lods;

let view = new MapView({
  container: "viewDiv",
  map,
  scale: 1,
  center,
  spatialReference,
  constraints: {
    lods: lods,
    snapToZoom: false
  }
});

fromJSON(json){*}static

创建此类的新实例并使用从 GeoScene 产品生成的 JSON 对象值对其进行初始化。传入到输入 json 参数的对象通常来自对 REST API 中查询操作的响应或来自另一个 GeoScene 产品的 toJSON() 方法。有关何时以及如何使用该函数的详细信息和示例，请参阅指南中的使用 fromJSON() 主题。

参数

json Object GeoScene 格式实例的 JSON 表示。有关各种输入 JSON 对象的结构示例，请参阅 GeoScene REST API 文档。

返回

类型	描述
*	返回该类的新实例。

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

scaleToZoom(scale){Number}

用于将比例值转换为其相应缩放值的实用程序方法。

参数

scale Number 要转换的比例值。

返回

类型	描述
Number	返回的缩放值。

示例

// get the zoom value for the vector tile layer at the given scale
// then set the view.zoom to match layer's zoom level.
view.when(function(){
  view.zoom = layer.tileInfo.scaleToZoom(9027);
});

toJSON(){Object}

将此类的实例转换为 GeoScene Portal JSON 表示。有关详细信息，请参阅使用 fromJSON() 指南主题。

返回

类型	描述
Object	此类实例的 GeoScene Portal JSON 表示。

zoomToScale(zoom){Number}

用于将缩放值转换为其相应比例值的实用程序方法。

参数

zoom Number 要转换的缩放值。

返回

类型	描述
Number	返回的比例值。

示例

// get the scale value for the vector tile layer at the view zoom level
// then set the view.scale to match layer's scale.
view.when(function(){
  view.scale = vectorLayer.tileInfo.zoomToScale(view.zoom);
});