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

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 属性的新值。
这个类用来表示经度和纬度对。
表示边界类实例。使用bounds之前需要设置left,bottom, right, top四个属性,这些属性的初始值为null。
{String} 图像的MIME类型,默认为 “image/png”。当前只支持这一种格式。
{Object} 请求中的额外参数。若是KVP方式的请求,这些属性会在URL的查询字符串中; 若为REST方式的请求,这些属性会在请求的路径中。
clone: function( obj )
克隆此图层。 Parameters: obj - {Object}
mergeNewParams: function( newParams )
为 params 附加新值,图层会被自动刷新。 仅在 KVP 方式的请求时有效。
所有SuperMap iServer 6R 定义的图层类的基类。 备注:CanvasLayer有Canvas和NoCanvas两种渲染方式,在多个栅格图层情况下不建议Canvas与NoCanvas同时使用,避免不能改变图层顺序的问题
{SuperMap.LonLat} 瓦片矩阵左上角。如果发布的矩阵集中每个矩阵原点不同, 则需要在<matrixIds>属性中包含<topLeftCorner>的值。若未提供,那么瓦片的左上角 将设置为图层 <maxExtent>属性的左上角。
创建该类的新实例。
Close