SuperMap.Layer.WMTS

该类用于访问图片服务器，基于OGC WMTS 1.0.0 标准实现，该服务支持三种请求模式：HTTP KVP（Key-Value Pair）方式、SOAP * 方式、REST 方式。 SuperMap iServer 目前提供了KVP、 REST两种方式的实现。

图层的url、matrixSet、layer、style、matrixIds、resolutions为必设属性. 当matrixIds设置字符串数组时，传入矩阵标识符列表，所设置的各级图层矩阵标识符要求与地图分辨率resolutions一一对应; 当matrixIds设置为对象数组时，此数组应与WMTS capabilities 中声明矩阵的描述一致，对象属性参考matrixIds属性描述。如果未设置matrixIds，则矩阵标识符（identifier）默认为地图缩放级别的interger值：”0”、”1”、”2”...等。 resolutions属性继承于父类layer，用户在创建WMTS图层时需要依照服务端出图的标准比例尺集( GlobalCRS84Scale、 GlobalCRS84Pixel、 GoogleCRS84Quad、 GoogleMapsCompatible)设置此属性，否则在出图时可能会出现地图偏差等问题。用户自定义缩放级别时须同时设置resolutions和matrixIds信息，并保证两者信息一一对应。各个标准比例尺集对应的分辨率数组如下：

var GlobalCRS84ScaleResolutions = [1.25764139776733, 0.628820698883665, 0.251528279553466,
    0.125764139776733, 0.0628820698883665, 0.0251528279553466, 0.0125764139776733, 0.00628820698883665,
    0.00251528279553466, 0.00125764139776733, 0.000628820698883665, 0.000251528279553466,
    0.000125764139776733, 0.0000628820698883665, 0.0000251528279553466, 0.0000125764139776733,
    0.00000628820698883665, 0.00000251528279553466, 0.00000125764139776733, 0.000000628820698883665,
    0.00000025152827955346
];

var GoogleCRS84QuadResolution = [1.40625000000000, 0.703125000000000, 0.351562500000000, 0.175781250000000,
    0.0878906250000000, 0.0439453125000000, 0.0219726562500000, 0.0109863281250000,
    0.00549316406250000, 0.00274658203125000, 0.00137329101562500, 0.000686645507812500,
    0.000343322753906250, 0.000171661376953125, 0.0000858306884765625,
    0.0000429153442382812, 0.0000214576721191406, 0.0000107288360595703, 0.00000536441802978516
];

var GlobalCRS84PixelResolution= [240000, 120000, 60000, 40000,
    20000, 10000, 4000, 2000,
      1000, 500, 166, 100,
      33, 16, 10, 3,
      1, 0.33
];

var GoogleMapsCompatibleResolutions = [156543.0339280410, 78271.51696402048, 39135.75848201023,
    19567.87924100512, 9783.939620502561, 4891.969810251280, 2445.984905125640,
    1222.992452562820, 611.4962262814100, 305.7481131407048, 152.8740565703525,
    76.43702828517624, 38.21851414258813, 19.10925707129406, 9.554628535647032,
    4.777314267823516, 2.388657133911758, 1.194328566955879, 0.5971642834779395
];

Inherits from

SuperMap.CanvasLayer

Summary

SuperMap.Layer.WMTS	该类用于访问图片服务器，基于OGC WMTS 1.0.0 标准实现，该服务支持三种请求模式：HTTP KVP（Key-Value Pair）方式、SOAP * 方式、REST 方式。 SuperMap iServer 目前提供了KVP、 REST两种方式的实现。
Properties
dimensions	{Array} REST请求编码，设置 WMTS 标准中其他可选属性设置。该属性中的项应为 params 属性设置的对象属性名，且一一对应。
format	{String} 图像的MIME类型，默认为 “image/png”。当前只支持这一种格式。
formatSuffix	{String} REST请求编码，图片请求必须包括的图片后缀名。若未提供，则从 format 属性中获取。
isBaseLayer	{Boolean} 图层是否为基础图层，默认为true。
layer	{String} WMTS服务发布的图层标识符，必设属性，默认为null。所请求的地图的名称。必须有且唯一。如：”China400”
matrixIds	{Array} 矩阵标识符列表。若未提供，那么矩阵标识符会被假定为地图地图缩放级别，且该属性子项为 integer类型。若指定为字符串数组，矩阵标识符应与地图缩放级别对应。另外，也可以设置为对象数组。对象应于WMTS capabilities中声明矩阵的描述一致。对象属性设置如下：
matrixSet	{String} 发布的标识符矩阵集，必设属性。
params	{Object} 请求中的额外参数。若是KVP方式的请求，这些属性会在URL的查询字符串中；若为REST方式的请求，这些属性会在请求的路径中。
requestEncoding	{String} 请求编码。可以是 “REST” 或者 “KVP”，默认为”KVP”。
style	{String} 发布的图层样式，默认为”default”。 SuperMap iServer 目前只提供默认样式，因此其值可以省略或者设为 “default”。
tileFullExtent	{SuperMap.Bounds} 瓦片设置的最大范围。如果没有提供，则将会用图层的<maxExtent>。
tileOrigin	{SuperMap.LonLat} 瓦片矩阵左上角。如果发布的矩阵集中每个矩阵原点不同，则需要在<matrixIds>属性中包含<topLeftCorner>的值。若未提供，那么瓦片的左上角将设置为图层 <maxExtent>属性的左上角。
url	{Array(String) or String} WMTS图层的服务地址，必设属性，是数组也可以是单个url，前者支持多地图服务轮询出图，大大提高显示速度。如：”http://localhost:8090/iserver/services/map-china400/wmts100” ，默认为null
zoomOffset	{Number} 当WMTS提供的图片级别比该图层需要访问的基本多时，可设置该属性，默认值为0。偏移量会与当前地图的缩放级别相加，进而决定该图层请求时的级别。例如：该属性设置为 3，地图级别为 0 时，图层会从缓存的第 3 级别开始请求。此外，该图层为叠加图层，且缓存级别低于底图时，可将此属性设置为负值。比如：地图级别为 1，WMTS图层级别为 0时，该属性可设置为 -1。
Constructor
SuperMap.Layer.WMTS	创建该类的新实例。
Functions
clone	克隆此图层。 Parameters: obj - {Object}
mergeNewParams	为 params 附加新值，图层会被自动刷新。仅在 KVP 方式的请求时有效。

Properties

isBaseLayer

{Boolean} 图层是否为基础图层，默认为true。

requestEncoding

{String} 请求编码。可以是 “REST” 或者 “KVP”，默认为”KVP”。

url

{Array(String) or String} WMTS图层的服务地址，必设属性，是数组也可以是单个url，前者支持多地图服务轮询出图，大大提高显示速度。如：”http://localhost:8090/iserver/services/map-china400/wmts100” ，默认为null

layer

{String} WMTS服务发布的图层标识符，必设属性，默认为null。所请求的地图的名称。必须有且唯一。如：”China400”

matrixSet

{String} 发布的标识符矩阵集，必设属性。

style

{String} 发布的图层样式，默认为”default”。 SuperMap iServer 目前只提供默认样式，因此其值可以省略或者设为 “default”。

format

{String} 图像的MIME类型，默认为 “image/png”。当前只支持这一种格式。

tileOrigin

{SuperMap.LonLat} 瓦片矩阵左上角。如果发布的矩阵集中每个矩阵原点不同，则需要在<matrixIds>属性中包含<topLeftCorner>的值。若未提供，那么瓦片的左上角将设置为图层 <maxExtent>属性的左上角。

tileFullExtent

{SuperMap.Bounds} 瓦片设置的最大范围。如果没有提供，则将会用图层的<maxExtent>。

formatSuffix

{String} REST请求编码，图片请求必须包括的图片后缀名。若未提供，则从 format 属性中获取。

matrixIds

{Array} 矩阵标识符列表。若未提供，那么矩阵标识符会被假定为地图地图缩放级别，且该属性子项为 integer类型。若指定为字符串数组，矩阵标识符应与地图缩放级别对应。另外，也可以设置为对象数组。对象应于WMTS capabilities中声明矩阵的描述一致。对象属性设置如下：

Matrix properties

identifier	{String} 矩阵标识符。
topLeftCorner	{SuperMap.LonLat} 左上角,如果与 tileOrigin 不同，必须设置。
tileWidth	{Number} 瓦片矩阵宽度。如果与<tileSize>不同则必须设置。
tileHeight	{Number} 瓦片矩阵高度。如果与<tileSize>不同则必须设置。

dimensions

{Array} REST请求编码，设置 WMTS 标准中其他可选属性设置。该属性中的项应为 params 属性设置的对象属性名，且一一对应。

params

{Object} 请求中的额外参数。若是KVP方式的请求，这些属性会在URL的查询字符串中；若为REST方式的请求，这些属性会在请求的路径中。

zoomOffset

{Number} 当WMTS提供的图片级别比该图层需要访问的基本多时，可设置该属性，默认值为0。偏移量会与当前地图的缩放级别相加，进而决定该图层请求时的级别。例如：该属性设置为 3，地图级别为 0 时，图层会从缓存的第 3 级别开始请求。此外，该图层为叠加图层，且缓存级别低于底图时，可将此属性设置为负值。比如：地图级别为 1，WMTS图层级别为 0时，该属性可设置为 -1。

Constructor

SuperMap.Layer.WMTS

创建该类的新实例。

例如

var matrixIds = new Array(21);
for (var i = 0; i < 22; ++i) {
    matrixIds[i] = {identifier:i};
};
//当前图层的分辨率数组信息,和matrixIds一样，需要用户从wmts服务获取并明确设置,resolutions数组和matrixIds数组长度相同
var resolutions = [1.25764139776733,0.628820698883665,0.251528279553466,
    0.125764139776733,0.0628820698883665,0.0251528279553466,0.0125764139776733,0.00628820698883665,
    0.00251528279553466,0.00125764139776733,0.000628820698883665,0.000251528279553466,
    0.000125764139776733,0.0000628820698883665,0.0000251528279553466,0.0000125764139776733,
    0.00000628820698883665,0.00000251528279553466,0.00000125764139776733,0.000000628820698883665,0.000000251528279553466];
var wmts = new SuperMap.Layer.WMTS({
    name: "World",
    url: "http://localhost:8090/iserver/services/map-World/wmts100",
    layer: "World",
    style: "default",
    matrixSet: "GlobalCRS84Scale_World",
    resolutions: resolutions,
    matrixIds: matrixIds
});

Parameters

config

{Object} 设置该类开放的属性。

Required configuration properties

name	{String} 图层名称，如”世界地图”，可选参数。
url	{Array(String) or String} WMTS图层的服务地址，是数组也可以是单个url，前者支持多地图服务轮询出图，大大提高显示速度。
layer	{String} 图层标识符，必设参数。
style	{String} 图层样式标识符，可选参数。
matrixSet	{String} 瓦片矩阵集标识符，必设参数。
format	{String} 图片格式，可选参数。
resolutions	{Array(Number)} 分辨率数组，必设参数。
matrixIds	{Array(Number)} 矩阵标识符列表，必设参数。

Functions

clone

clone: function( obj )

克隆此图层。 Parameters: obj - {Object}

Returns

{SuperMap.Layer.WMTS} 克隆后的<SuperMap.Layer.WMTS>图层。

mergeNewParams

mergeNewParams: function( newParams )

为 params 附加新值，图层会被自动刷新。仅在 KVP 方式的请求时有效。

Parameters

newParams

{Object} 附加到 params 属性的新值。