SuperMap.Layer.TiledDynamicRESTLayer

SuperMap iServer Java 6R 及以上分块动态 REST 图层, 用于对接 SuperMap iServer 的 REST 地图服务的分块动态栅格图层,有关 REST (REpresentational State Transfer,表述性状态转移)服务请参见 “SuperMap iServer Java 6R 帮助文档 “。

Inherits from

Summary
SuperMap.Layer.TiledDynamicRESTLayer SuperMap iServer Java 6R 及以上分块动态 REST 图层, 用于对接 SuperMap iServer 的 REST 地图服务的分块动态栅格图层,有关 REST (REpresentational State Transfer,表述性状态转移)服务请参见 “SuperMap iServer Java 6R 帮助文档 “。
Constants
DEFAULT_PARAMS {Object} 设置到瓦片url请求上的参数的默认值。 transparent(图层是否透明,默认为false) 和cacheEnabled(是否使用服务端的缓存,默认为true)
EVENT_TYPES {Array(String)} 此类支持的事件类型。
Properties
credential {<Supermap.Credential>} 图层独立的安全验证信息,比如 token。需要在初始化的时候就传进去
dpi {Number}图像分辨率,表示每英寸内的像素个数。
overlapDisplayed {Boolean} 地图对象在同一范围内时,是否重叠显示,默认为false。 如果为true,则同一范围内的对象会直接压盖;如果为false则通过 overlapDisplayedOptions 控制对象不压盖显示 。
overlapDisplayedOptions {SuperMap.REST.OverlapDisplayedOptions} 避免地图对象压盖显示的过滤选项, 当 overlapDisplayed为 false 时有效,用来增强对地图对象压盖时的处理。
redirect {Boolean} 是否重定向,HTTP 传输中的一个概念。如果为 true,则将请求重定向到图片的真实地址; 如果为 false,则响应体中是图片的字节流。默认为 false,不进行重定向。缓存版本 5.0 不支持重定向。
Constructor
SuperMap.Layer.TiledDynamicRESTLayer 所有SuperMap iServer 6R 分块动态 REST 图层。
Functions
clone 创建当前图层的副本。
destroy 解构TiledDynamicRESTLayer类,释放资源。

Constants

DEFAULT_PARAMS

{Object} 设置到瓦片url请求上的参数的默认值。 transparent(图层是否透明,默认为false) 和cacheEnabled(是否使用服务端的缓存,默认为true)

EVENT_TYPES

{Array(String)} 此类支持的事件类型。

  • layerInitialized 初始化 TiledDynamicRESTLayer 时该图层发送获取地图 状态的请求,根据响应信息初始化图层参数。当初始化完成后触发该事件, 用户可以在该事件的响应函数中将该图层添加到地图中。例如:
//使用下面的方法将图层添加到map
var layer = new SuperMap.Layer.TiledDynamicRESTLayer("layerName", layerURL, {transparent: true});
layer.events.on({"layerInitialized": addLayer});
   function addLayer() {
    map.addLayer(layer);
    map.setCenter(new SuperMap.LonLat(0, 0), 0);
}
  • loadError 初始化 TiledDynamicRESTLayer 时该图层发送获取地图 状态的请求,根据响应信息初始化图层参数。如果初始化图层参数失败,触发该事件。

Properties

dpi

{Number}图像分辨率,表示每英寸内的像素个数。

credential

{<Supermap.Credential>} 图层独立的安全验证信息,比如 token。需要在初始化的时候就传进去

overlapDisplayed

{Boolean} 地图对象在同一范围内时,是否重叠显示,默认为false。 如果为true,则同一范围内的对象会直接压盖;如果为false则通过 overlapDisplayedOptions 控制对象不压盖显示 。

redirect

{Boolean} 是否重定向,HTTP 传输中的一个概念。如果为 true,则将请求重定向到图片的真实地址; 如果为 false,则响应体中是图片的字节流。默认为 false,不进行重定向。缓存版本 5.0 不支持重定向。

overlapDisplayedOptions

{SuperMap.REST.OverlapDisplayedOptions} 避免地图对象压盖显示的过滤选项, 当 overlapDisplayed为 false 时有效,用来增强对地图对象压盖时的处理。

Constructor

SuperMap.Layer.TiledDynamicRESTLayer

所有SuperMap iServer 6R 分块动态 REST 图层。

// 向服务端发送请求获取后,获取透明、使用服务端缓存的图层,
// 通过options可以设置TiledDynamicRESTLayer的属性及其父类的属性
var layer = new SuperMap.Layer.TiledDynamicRESTLayer("World", World_Map,
    {transparent: true, cacheEnabled:true}, {maxResolution:"auto"});

Parameters

name {String} 图层标识名称。
url {Array(String) or String} 图层的服务地址,是数组也可以是单个url,前者支持多地图服务轮询出图,大大提高显示速度。
params {Object} 设置到url上的可选参数。
options {Object} 此类及其父类开放的属性,包括dpi、maxExtent、resolutions、scales、units、datumAxis六个参数, 获取方式有两种:一是从服务端获取,二是用户自己设置得到,其中,对于units参数,如果用户设置了此参数, 即使已经成功从服务端获取,但是依然会优先使用用户设置的units参数。 当Layer的options设置了units参数,则用Layer的units计算dpi; 如果options没有设置untis,此时会参照Map上的units计算dpi, 此时需要注意的是,如果Layer是在平面坐标系下,Map的options必须设置untis,如果是地理坐标系的情况下可以不设置, 系统默认为“degree”。

Allowed params properties

clipRegion {SuperMap.Geometry} 地图显示裁剪的区域。
transparent {Boolean} 图层是否透明,默认为 false,即不透明。
cacheEnabled {Boolean} 是否使用服务端的缓存,默认为 true,即使用服务端的缓存。
layersID {String} 需要进行切片的地图图层 ID,即指定进行地图切片的图层,可以是临时图层集,也可以是当前地图中图层的组合。如果此参数缺省则对全部图层进行切片。 layersID可以是临时图层创建时templayers的ID,如layersID=382139acf0,也可以是当前地图中的某些图层的ID编号。其中,当前地图图层ID的定义规则如下: 1.  各级图层按照图层顺序自上而下从0开始编号; 2.  冒号(:)前为顶级图层; 3.  英文句号(.)表示其他各级图层间的从属关系; 4.  英文逗号(,)表示图层间的分隔。 例如: 1.  [0:0,1,2.0]表示顶级图层0下面的子图层:0、1及其下属所有子图层,和2下的子图层0; 2.  [1:1.2,2]表示顶级级图层1下面的子图层:1下的子图层2,和图层2及其下属所有子图层; 3.  两个示例合并在一起则是:[0:0,1,2.0,1:1.2,2]。此外,[0,1,2,3]表示顶级图层0下面的图层0、1、2、3及所有子图层,[0:,1:,2:]表示顶级图层0、1、2及其所有子图层。 4、当我们初始化图层之后还想改变图层显示时可以直接如下进行设置: layer.params.layersID = “[0:0,1,7,11]”; //图层索引为0、1、7和11的显示,其他不显示 layer.redraw();
overlapDisplayedOptions {SuperMap.REST.OverlapDisplayedOptions} 避免地图对象压盖显示的过滤选项,当 overlapDisplayed为 false 时有效,用来增强对地图对象压盖时的处理。默认值null。
overlapDisplayed {Boolean} 地图对象在同一范围内时,是否重叠显示,默认为false。
redirect {Boolean} 是否重定向,HTTP 传输中的一个概念。如果为 true,则将请求重定向到图片的真实地址。缓存版本 5.0 不支持重定向。 如果为 false,则响应体中是图片的字节流。默认为 false,不进行重定向。

Allowed options properties

resolutions {Array} 分辨率数组。如果设置了dpi,resolutions和scales设置其一
scales {Array} 比例尺数组。如果设置了dpi,resolutions和scales设置其一
dpi {Number} 图像分辨率,表示每英寸内的像素个数。
units {String} 地图坐标系统的单位。
datumAxis {Number} 椭球体长半轴。
format {String} 栅格图层图片格式、支持png、jpg、gif和bmp。
projection {SuperMap.Projection} or {String} 创建图层时,在图层的 options 上设置当前图层默认的投影字符串。如“EPSG:900913”

Functions

destroy

destroy: function ()

解构TiledDynamicRESTLayer类,释放资源。

clone

clone: function ( obj )

创建当前图层的副本。

Parameters

obj {Object}

Returns

{SuperMap.Layer.TiledDynamicRESTLayer} 新的图层。

地图压盖过滤显示选项。 在文本或专题图元素显示较密集的区域,文本之间或专题元素之间会发生相互压盖的现象, 该类可以分别控制各种类型的对象的压盖显示情况,进而很好地处理地图中各种类型对象的压盖显示问题。
destroy: function ()
解构TiledDynamicRESTLayer类,释放资源。
clone: function ( obj )
创建当前图层的副本。
所有SuperMap iServer 6R 定义的图层类的基类。 备注:CanvasLayer有Canvas和NoCanvas两种渲染方式,在多个栅格图层情况下不建议Canvas与NoCanvas同时使用,避免不能改变图层顺序的问题
几何对象类,描述地理对象的几何图形。
坐标转换类。这个类封装了与 proj4js 投影对象进行交互的几种方法。
字符串操作的一系列常用扩展函数.
所有SuperMap iServer 6R 分块动态 REST 图层。
Close