Class: WMTSLayer

// ES5引入方式
const { WMTSLayer } = zondy.layer
// ES6引入方式
import { WMTSLayer } from "@mapgis/webclient-common"
// 初始化WMTS图层
const wmtsLayer = new WMTSLayer({
  // 服务基地址
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/WMTSServer'
});

// ES5引入方式
const { WMTSLayer } = zondy.layer
// ES6引入方式
import { WMTSLayer } from "@mapgis/webclient-common"
// 初始化WMTS图层
const wmtsLayer = new WMTSLayer({
  url: 'http://{ip}:{port}/arcgis/rest/services/{serviceName}/MapServer/WMTS'
});

// ES5引入方式
const { WMTSLayer } = zondy.layer
// ES6引入方式
import { WMTSLayer } from "@mapgis/webclient-common"
初始化WMTS图层
const wmtsLayer = new WMTSLayer({
  // 加载经纬度的影像地图
  url: 'http://t6.tianditu.gov.cn/img_c/wmts',
  // 天地图必须加token，且token名为tk
  tokenKey: 'tk',
  // token请在天地图官网申请
  tokenValue: '天地图token'
});

// ES5引入方式
const { WMTSLayer } = zondy.layer
// ES6引入方式
import { WMTSLayer } from "@mapgis/webclient-common"
// 初始化时设置
const wmtsLayer = new WMTSLayer({
  // 服务基地址
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/WMTSServer',
  // 设置透明度
  opacity: 1.0
});

// 加载完成后设置
wmtsLayer.on('layerview-created', function (result) {
  console.log("加载完毕:", result.layer)
  // 设置透明度
  wmtsLayer.opacity = 0.5
})

// ES5引入方式
const { WMTSLayer } = zondy.layer
// ES6引入方式
import { WMTSLayer } from "@mapgis/webclient-common"
// 初始化时设置
const wmtsLayer = new WMTSLayer({
  // 服务基地址
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/WMTSServer',
  // 设置图层显隐
  visible: true
});

// 加载完成后设置
wmtsLayer.on('layerview-created', function (result) {
  console.log("加载完毕:", result.layer)
  // 设置图层显隐
  wmtsLayer.visible = !wmtsLayer.visible
})

map.remove(wmtsLayer)

// ES5引入方式
const { WMTSLayer } = zondy.layer
// ES6引入方式
import { WMTSLayer } from "@mapgis/webclient-common"
// 初始化一个WMTS图层
const wmtsLayer = new WMTSLayer({
  // 服务基地址
  url: 'http://{ip}:{port}/{path}',
  activeLayer:{
     id: "city",
        tileMatrixSetId: "EPSG:4326",
        styleId: "point",
        imageFormat: "image/png",
  }
})
// 将WMTS图层添加到Map中
map.add(layer)

// ES5引入方式
const { WMTSLayer } = zondy.layer
// ES6引入方式
import { WMTSLayer } from "@mapgis/webclient-common"
// 初始化一个WMTS图层
const wmtsLayer = new WMTSLayer({
  // 服务基地址
  url: 'http://{ip}:{port}/{path}',
  activeLayer:{
     id: "city",
        tileMatrixSetId: "EPSG:4326",
        styleId: "point",
        imageFormat: "image/png",
  }
})

wmtsLayer.on("layerview-created", function (result) {
 // 切换活跃图层瓦片集
    wmtsLayer.activeLayer.tileMatrixSetId = "EPSG:900913";
   });
// 将WMTS图层添加到Map中
map.add(layer)

Extends

• OGCLayer

Members

activeLayerWMTSSubLayer

当前处于活动状态的子图层

allSublayersCollection

所有子图层对象信息

capabilitiesObject

图层支持能力。图层支持能力分为客户端能力和服务端能力，其中客户端能力包含cesium、leaflet、mapboxgl引擎能力。默认图层客户端能力：所有引擎支持图层加载；默认图层服务端能力为空。

clippingAreaPolygon Extent Circle MultiPolygon null

空间裁剪范围

clippingAreaPolygon Extent Circle MultiPolygon null

空间裁剪范围

copyrightString

版权所有

corporationTypeNumber

公司代码

corporationTypeNumber

WMTS 公司代码

customParametersObject

自定义查询参数customParameters

descriptionString

图层描述

extendPropsObject

额外属性，当前图层对象上不支持的属性，二次开发用户希望挂在图层对像上的属性可以存储到该属性中

Default Value:

{}

Events

inherited 图层加载完毕事件

document/layer/baseLayer/Layer.js, line 46

图层加载完毕事件

Properties:

Name	Type	Description
event	Object	事件对象 Properties Name Type Default Description type String 'layerview-created' 可选 图层加载完毕事件 message String null 可选 更新描述 UpdateContent Array.<UpdateContent> null 可选 更新详情对象 layer Layer null 可选 地图图层对象 layerView MapView null 可选 图层的视图对象 sourceTarget Layer null 可选 事件发起对象 target Map null 可选 事件接收对象

Example

图层加载完毕事件

Layer.on('layerview-created', function (result) {
  console.log("加载完毕:", result.layer)
});

inherited 图层显隐更新完毕事件

document/layer/baseLayer/Layer.js, line 90

图层显隐更新完毕事件，请注意该事件是图层更新事件(layerview-update)的子事件

Properties:

Name	Type	Description
event	Object	事件对象 Properties Name Type Default Description type String 'layerview-update' 可选 图层更新完毕事件 message String null 可选 更新描述 updateContent Array.<UpdateContent> null 可选 更新详情对象 layer Layer null 可选 地图图层对象 layerView MapView null 可选 图层的视图对象 sourceTarget Layer null 可选 事件发起对象 target Map null 可选 事件接收对象

Example

图层显隐更新完毕事件

Layer.on('layerview-update', function (event) {
  // 获取更新事件对象
  console.log("更新完毕:", event)
  // 获取更新详情数组
  const updateContent = event.updateContent
  // 循环数组，根据事件名进行后续操作
  for (let i = 0; i < updateContent.length; i++) {
    // 图层显隐事件
    if(updateContent[i].name === 'visible'){
      console.log("图层显隐更新事件:", event);
    }
  }
});

inherited 图层比例尺显示隐藏状态更新事件。当前仅支持非组图层以及场景子图层

document/layer/baseLayer/Layer.js, line 144

图层刷新完毕事件，请注意该事件是图层更新事件(layerview-update)的子事件

Properties:

Name	Type	Description
event	Object	事件对象 Properties Name Type Default Description type String 'layerview-update' 可选 图层更新完毕事件 message String null 可选 更新描述 updateContent Array.<UpdateContent> null 可选 更新详情对象 layer Layer null 可选 地图图层对象 layerView MapView null 可选 图层的视图对象 sourceTarget Layer null 可选 事件发起对象 target Map null 可选 事件接收对象
event	LayerViewScaleVisibleEvent	事件对象 layer.on('layerview-scale-visible', (event) => { console.log("图层比例尺显示隐藏状态更新事件:", event) })

Example

图层刷新完毕事件

Layer.on('layerview-update', function (event) {
  // 获取更新事件对象
  console.log("更新完毕:", event)
  // 获取更新详情数组
  const updateContent = event.updateContent
  // 循环数组，根据事件名进行后续操作
  for (let i = 0; i < updateContent.length; i++) {
    // 图层刷新完毕事件
    if(updateContent[i].name === 'refresh'){
      console.log("图层刷新完毕事件:", event);
    }
  }
});

/**

inherited 图层视图更新事件

document/layer/baseLayer/Layer.js, line 80

图层视图更新事件

Properties:

Name	Type	Description
event	LayerViewUpdateEvent	事件对象

Example

图层更新完毕事件

Layer.on('layerview-update', function (result) {
  console.log("更新完毕:", result.layer)
});

inherited 图层透明度更新完毕事件

document/layer/baseLayer/Layer.js, line 117

图层透明度更新完毕事件，请注意该事件是图层更新事件(layerview-update)的子事件

Properties:

Name	Type	Description
event	Object	事件对象 Properties Name Type Default Description type String 'layerview-update' 可选 图层更新完毕事件 message String null 可选 更新描述 updateContent Array.<UpdateContent> null 可选 更新详情对象 layer Layer null 可选 地图图层对象 layerView MapView null 可选 图层的视图对象 sourceTarget Layer null 可选 事件发起对象 target Map null 可选 事件接收对象

Example

图层透明度更新完毕事件

Layer.on('layerview-update', function (event) {
  // 获取更新事件对象
  console.log("更新完毕:", event)
  // 获取更新详情数组
  const updateContent = event.updateContent
  // 循环数组，根据事件名进行后续操作
  for (let i = 0; i < updateContent.length; i++) {
    // 图层透明度更新事件
    if(updateContent[i].name === 'opacity'){
      console.log("图层透明度更新事件:", event);
    }
  }
});

inherited 图层销毁完毕事件

document/layer/baseLayer/Layer.js, line 63

图层销毁完毕事件

Properties:

Name	Type	Description
event	Object	事件对象 Properties Name Type Default Description type String 'layerview-remove' 可选 图层销毁完毕事件 message String null 可选 更新描述 updateContent Array.<UpdateContent> null 可选 更新详情对象 layer Layer null 可选 要销毁的地图图层对象 layerView MapView null 可选 图层的视图对象 sourceTarget Layer null 可选 事件发起对象 target Map null 可选 事件接收对象

Example

图层销毁完毕事件

Layer.on('layerview-remove', function (result) {
  console.log("销毁完毕:", result.layer)
});

Methods

WMTSLayer.fromJSON(json)

document/layer/ogc/WMTSLayer.js, line 505

通过传入的json构造并返回一个新的几何对象

Name	Type	Description
json	Object	可选 JSON对象

Example

通过传入的json构造并返回一个新的几何对象

// ES5引入方式
const { WMTSLayer } = zondy.layer
// ES6引入方式
import { WMTSLayer } from "@mapgis/webclient-common"
const json = {
  // 服务基地址
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/WMTSServer'
}
const wmtsLayer = new WMTSLayer.fromJSON(json)

WMTSLayer.fromServerUrl(url){WMTSLayer}

document/layer/ogc/WMTSLayer.js, line 1085

通过url创建图层对象

Name	Type	Description
url	String	服务基地址

Returns:

Type	Description
WMTSLayer	新的图层对象

Example

通过url创建图层对象

// ES5引入方式
const { WMTSLayer } = zondy.layer
// ES6引入方式
import { WMTSLayer } from "@mapgis/webclient-common"
// 初始化图层
const url = 'http://{ip}:{port}/igs/rest/services/{serviceName}/WMTSServer';
const wmtsLayer = new WMTSLayer.fromServerUrl(url);

_getBoundingBoxBySpatialReference(boundingBoxes, spatialReference){Object}

document/layer/ogc/WMTSLayer.js, line 752

从BoundingBox数组中找到坐标系和输入的参考坐标系相同的BoundingBox，没有找到则取第一个

Name	Type	Description
boundingBoxes	Array.<Object>	BoundingBox数组，格式为： [{ xmin: xmin, ymin: ymin, xmax: xmax, ymax: ymax, crs: SpatialReference },...]
spatialReference	SpatialReference	参考坐标系对象

Returns:

Type	Description
Object	找到的BoundingBox对象，可能为空，格式为： { xmin: xmin, ymin: ymin, xmax: xmax, ymax: ymax, crs: SpatialReference }

clone(){WMTSLayer}

document/layer/ogc/WMTSLayer.js, line 551

克隆WMTSLayer对象

Returns:

Type	Description
WMTSLayer	克隆后的WMTSLayer实例

inherited destroy(){*}

document/layer/baseLayer/Layer.js, line 618

Returns:

Type	Description
*

findSublayerById(id){WMTSSubLayer}

document/layer/ogc/WMTSLayer.js, line 666

根据id查询子图层

Name	Type	Description
id	Object	子图层的id

Returns:

Type	Description
WMTSSubLayer	找到的子图层对象

getCurrentTileInfo(){TileInfo}

document/layer/ogc/WMTSLayer.js, line 559

获取当前图层瓦片裁图信息

Returns:

Type	Description
TileInfo

inherited getProperty(path){*}

document/layer/baseLayer/Layer.js, line 818

获取属性

Name	Type	Description
path	String

Returns:

Type	Description
*	属性值

inherited isLoaded(){Boolean}

document/layer/baseLayer/Layer.js, line 543

判断图层是否加载成功

Returns:

Type	Description
Boolean	图层是否加载成功

load()

document/layer/ogc/WMTSLayer.js, line 593

加载图层资源

Example

不加载图层，仅获取图层信息

// ES5引入方式
const { WMTSLayer } = zondy.layer
// ES6引入方式
import { WMTSLayer } from "@mapgis/webclient-common"
// 初始化图层
const wmtsLayer = new WMTSLayer({
  // 服务基地址
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/WMTSServer'
});
wmtsLayer.load().then((result) => {
  // 获取完图层信息
  console.log(wmtsLayer)
})

inherited refresh()

document/layer/baseLayer/Layer.js, line 747

刷新图层

inherited setProperty(path, value){Boolean}

document/layer/baseLayer/Layer.js, line 778

设置属性值或者属性路径对应的值。由于当前仅支持第一级属性响应，无法解决多级属性响应机制，此方法支持属性路径响应机制。例如:path输入'tileInfo.startLevel',则会响应式更新startLevel。

Name	Type	Description
path	String	属性路径，可以传入单个属性后者一个属性的路径
value	*

Returns:

Type	Description
Boolean	是否设置成功

toJSON(){Object}

document/layer/ogc/WMTSLayer.js, line 518

转换为json对象

Returns:

Type	Description
Object	json对象