layer~TMSLayer(name, layerUrl, options)

TMS瓦片地图服务。是tile map service的缩写,是一种瓦片地图服务,下文提到的切片等同于瓦片。TMS的算法思想是把投影后的世界地图按照层级进行四叉树切割,切割后的瓦片数量随层级指数式增长。
第n级比例尺下的瓦片片数量是Math.pow(2,n)。如果缩放过程中出现图片模糊的情况,建议把地图创建时的参数zoomInterval设置为1。

Summary

Methods:
fromHMapPlatform

通过空间信息服务平台元数据创建图层

dealOneTile

处理一张切片

getLayerType

获取图层类型

isBaseLayer

获取图层的baseLayer属性。

Constructor

new TMSLayer(name, layerUrl, options)

Parameters:
Name Type Description
name String

图层名称。

layerUrl String

TMS服务地址。如包含{x}、{y}、{z}参数,则在请求瓦片时将瓦片的行号({x})、列号({y})、级别({z})变量替换为实际的值,如URL使用比例尺({scale})变量,则请求时使用比例尺代替级别

options Object

在图层上设置的附加属性。

Name Type Description
matrixOrigin module:basetype~Coordinate

切片矩阵的原点坐标,也叫切片原点

serverScaleDenominators Array

服务端切片的比例尺,在使用serverResolutions选项时,本选项不生效

isReverse Boolean

表示级别z值是否为逆序(降序),默认值为false,即正序(顺序),如果是逆序,该值需赋值为true。

zoomOffset Number

表示该图层的级别z相对于地图分辨率数组中的级别的偏移量,默认值为0。

dataFormat String

切片格式,默认为‘png’。

dataMaxLevel Number

整数,表示当前图层中瓦片数据的最大级别,当地图缩放超过该值时,该图层中瓦片数据将被继续渲染。如果不设置或该值大于地图最大级别,则默认按地图对象的最大级别算。

buildTileTree Boolean

是否构建瓦片树,默认为true,当瓦片的相邻层级间分辨率为2倍关系时,设置构建瓦片树,瓦片之间具有父子兄弟关系,放大和缩小时,
切片显示会保持连续。当瓦片相邻层级间分辨率倍数不为2时,需要设置为false。若出现上一层级瓦片未消失情况影响到整体效果时(比如单纯的注记图层),可以将该值设为false效果更好。

imageFilter String

tms纹理图片采样方式。nearest代表临近采样,在正视视角下,纹理会更清晰;linear代表线性采样,对倾斜视角的场景更加友好,默认为nearest。

clearScreen Boolean

缩放操作时,在新的瓦片请求成功之前,是否绘制上一帧中的瓦片,默认false。参数为true时,当新瓦片请求成功之前,
绘制上一帧的瓦片,地图不再有空白时间,提升用户体验(当options.useLocalStorage为true时,不起作用)。但是如果新的瓦片请求不成功,则绘制上一帧中的瓦片时,
可能会有马赛克现象,可以设置为false解决。本参数将于下个版本弃用

baseGroundLayer Boolean

是否三维基础图层,如果设置成三维基础图层,贴地绘制的图层将会绘制到该图层上。

Example
let matrixOrigin = new hmap.basetype.Coordinate(-180, 90);
let tmsOptions = {
        matrixOrigin: matrixOrigin,//切片原点
        dataFormat: "png"//切片格式
};
let tmsLayer = new hmap.layer.TMSLayer("TMS图层", "http://10.20.84.15:8080/GeoData/map/SpiritMap/vec/", tmsOptions);

Members

depthTest

获取图层的深度测试属性
return {Boolean} 深度测试属性

Overrides:

Methods

static fromHMapPlatform(metadataUrl, options) → {Promise}

通过空间信息服务平台元数据创建图层

Parameters:
Name Type Description
metadataUrl String

空间信息服务平台服务对应的元数据地址

options options

可选项,对空间信息服务平台元数据不包含的可选项进行补充,若传入的可选项与元数据中重复,以元数据为准。

Returns:
Promise -

图层创建的promise,resolve返回图层实例

dealOneTile()

处理一张切片

getLayerType() → {String}

获取图层类型

Returns:
String -

图层类型

isBaseLayer() → {Boolean}

获取图层的baseLayer属性。

Returns:
Boolean -

图层是否是baseLayer,true即为是,false为不是

Example
tmsLayer.isBaseLayer();