包 | com.supermap.web.mapping |
类 | public class TiledDynamicRESTLayer |
继承 | TiledDynamicRESTLayer ![]() ![]() ![]() ![]() ![]() |
子类 | UTFGridLayer |
该类继承 TiledDynamicLayer,支持 SuperMap iServer Java 6R 的 REST 地图服务的分块动态栅格图层。必设属性为 Url。
REST (REpresentational State Transfer,表述性状态转移)是一种面向资源的架构(Resource-Oriented Architecture,ROA)风格。资源可以是具体的数据,也可以是能够实现某些功能的服务,资源通常由 URI(Uniform Resource Identifier,统一资源标识符)唯一标识,客户端的应用通过 URI 来获取资源的表述,客户端获得这些表述致使应用程序状态发生改变,即,表述性的状态转变。有关 REST 服务请参见 “SuperMap iServer Java 6R 帮助文档”。
属性 | 定义方 | ||
---|---|---|---|
adjustFactor : Number
获取或设置地图坐标比例因子,取值范围大于0,建议在 1 附近取值。如果发现图层叠加时有偏移,可通过该属性移动图层,使图层正确叠加。
|
TiledDynamicRESTLayer | ||
![]() |
bounds : Rectangle2D
当前图层的地理范围,若当前图层为 Map 的第一个图层,且 Map 的 ViewBounds 为 null,则将当前图层的 bounds 作为 Map 的 ViewBounds。一般情况下该属性默认值为(0,0,0,0)。若当前图层为 WMTS 图层(TiledWMTSLayer),则 bounds 的默认值参考 WMTS 标准而定...
|
Layer | |
clipRegion : GeoRegion
剪裁多边形。指定该属性后,当前图层仅显示该多边形内的地图。
|
TiledDynamicRESTLayer | ||
![]() |
CRS : CoordinateReferenceSystem
获取或设置当前图层的坐标参考系( CoordinateReferenceSystem )。默认值为 null。设置 CoordinateReferenceSystem.wkid 属性后,图层将被动态投影至 wkid 所代表的投影坐标系下,若 wkid 小于等于 0 则不进行动态投影...
|
Layer | |
customServiceParams : Object
获取或设置用户参数,如 DynamicRESTLayer.customServiceParams.angle = 90,用于设置当前图层的旋转角度.
|
TiledDynamicRESTLayer | ||
enableServerCaching : Boolean
获取或设置是否使用服务端的缓存,默认为 true,即使用服务端的缓存。在编辑功能时,需要将该属性设为 false,否则影响编辑后的显示效果。
|
TiledDynamicRESTLayer | ||
![]() |
fadeInFrameCount : uint
获取或设置图层在缩放过程中渐显帧数,这样可使缩放过程更加平滑。默认值为4.
|
TiledLayer | |
![]() |
imageFormat : String
获取或设置载入 ImageLayer 的图片格式,默认为 png 格式。
|
ImageLayer | |
![]() |
isInResolutionRange : Boolean
[read-only] 判断与当前图层关联的 Map 的分辨率是否在当前图层的最大、最小分辨率范围内。true 表示在最大、最小范围内。
|
Layer | |
isScaleCentric : Boolean
[Override] [read-only] 指示该图层是否有 DPI 值,ture 表示当前图层已根据从 SuperMap iServer 服务端获取的参数计算出 DPI;false 反之。WMS、WMTS 等图层该属性值为 false。DynamicRESTLayer、TiledDynamicRESTLayer 等专门关联 SuperMap iServer 服务的图层该属性为 true。
|
TiledDynamicRESTLayer | ||
layersID : String
图层 ID ,可以是临时图层集,也可以是当前地图中图层的组合。如果此参数缺省则对全部图层进行切片...
|
TiledDynamicRESTLayer | ||
![]() |
loaded : Boolean
[read-only] 若当前图层已加载完闭则返回 true,否则返回 false。
|
Layer | |
![]() |
localStorage : LocalStorage
LocalStorage 对象。该属性与 memoryStorageEnabled 属性为 true 时的功能类似,不同之处在于 memoryStorageEnabled 是将地图数据缓存至内存,且浏览器关闭后会被清除;而 localStorage 是将数据缓存至本地磁盘,由用户清除缓存数据...
|
TiledLayer | |
![]() |
maxVisibleResolution : Number
当前图层的最大显示分辨率。即当图层缩放至该分辨率时就不能再放大。
|
Layer | |
maxVisibleVertex : int
获取或设置最大几何对象可见节点数。如果图层中的某个几何对象的节点数超过指定的个数,则超过的那部分节点不显示。
|
TiledDynamicRESTLayer | ||
![]() |
memoryStorageEnabled : Boolean
是否使用内存数据。当该属性为 true 时表示在浏览器中浏览地图时,系统内部会自动将地图数据缓存至本地内存中,并读取已有的地图缓存数据。在浏览器未关闭的情况下,内存中的缓存数据会一直存在,用户在浏览地图时一直访问的是本地已缓存的数据,对于重复浏览地图可大幅提升浏览速度;若浏览器关闭,缓存会自动清除。默认值为 false...
|
TiledLayer | |
![]() |
metadata : Object
获取或设置当前图层信息,包括图层标题、描述信息、图层所在地图控件名称。
|
Layer | |
![]() |
minVisibleResolution : Number
当前图层的最小显示分辨率。即当图层缩放至该分辨率时就不能再缩小。
|
Layer | |
![]() |
origin : Point2D
获取或设置分块图层的起点坐标(左上角点).
|
TiledLayer | |
overlapDisplayed : Boolean
地图对象在同一范围内时,是否重叠显示,默认为false。
|
TiledDynamicRESTLayer | ||
overlapDisplayedOptions : OverlapDisplayedOptions
避免地图对象压盖显示的过滤选项,当 overlapDisplayed为 false 时有效,用来增强对地图对象压盖时的处理。
|
TiledDynamicRESTLayer | ||
redirect : Boolean
是否重定向,HTTP传输中的一个概念。如果为true,则将请求重定向到图片的真实地址;如果为false,则响应体中是图片的字节流。默认为false,不进行重定向。
|
TiledDynamicRESTLayer | ||
![]() |
resolution : Number
[read-only] 获取当前图层的显示分辨率。
|
Layer | |
![]() |
tileBufferCount : int | TiledLayer | |
![]() |
tileSize : int
获取或者设置图层分块大小,单位为像素,默认值为 512.
|
TiledLayer | |
tileversion : String
指定请求瓦片的版本号。
|
TiledDynamicRESTLayer | ||
![]() |
transparent : Boolean
指定图片是否透明显示。
|
ImageLayer | |
url : String
[Override] 图层所在的服务地址。
|
TiledDynamicRESTLayer | ||
urls : Array
TiledDynamicRESTLayer轮询出图服务地址
|
TiledDynamicRESTLayer | ||
![]() |
viewRegion : GeoRegion
获取或设置分块图层的出图控制范围.
|
TiledLayer | |
![]() |
visible : Boolean
[Override] 获取或设置当前图层是否可见。
|
Layer |
方法 | 定义方 | ||
---|---|---|---|
初始化 TiledDynamicRESTLayer 类的新实例。
|
TiledDynamicRESTLayer | ||
refresh():void
[Override] 刷新图层,即调用 Layer.invalidateDisplayList() 方法(详情请参见 Flex SDK UIComponent.invalidateDisplayList() 方法),更新 Layer 的显示列表。对于 GraphicsLayer 调用该方法会对 GraphicsLayer 上所有显示对象 Graphic 进行重绘。
|
TiledDynamicRESTLayer | ||
![]() |
selectUrls(row:int, col:int):String
|
TiledLayer |
方法 | 定义方 | ||
---|---|---|---|
![]() |
addedHandler(event:Event):void
处理 Event.ADDED 事件的侦听器函数。
|
Layer | |
![]() |
addMapListeners():void
[Override] 为当前图层添加事件侦听器,以使侦听器能够接收 ZoomEvent、 ViewBoundsEvent 事件的触发通知。
|
TiledLayer | |
![]() |
draw():void
[Override] 渲染出图,注意:子类必须重写该方法来实现渲染出图。
|
TiledLayer | |
getTileURL(row:int, col:int, resolution:Number):URLRequest
[Override] 获取指定图片块在服务器端的存放地址。
|
TiledDynamicRESTLayer | ||
![]() |
hideHandler(event:FlexEvent):void
[Override] 处理 FlexEvent.HIDE 事件的侦听器函数。
|
TiledLayer | |
![]() |
invalidateLayer():void
通过子类调用以更新图层。
|
Layer | |
![]() |
removeAllChildren():void
[Override] 删除 Layer 上的所有对象。
|
TiledLayer | |
![]() |
removedHandler(event:Event):void
[Override] 处理 Event.REMOVED 事件的侦听器函数。
|
TiledLayer | |
![]() |
removeMapListeners():void
[Override] 移除通过 addMapListeners 添加的事件侦听器。
|
TiledLayer | |
![]() |
setLoaded(value:Boolean):void
设置图层是否加载完闭,会触发 LayerEvent.LOAD 事件。true 表示当前图层已加载完毕。注意:任何继承 Layer 的子类都必须在 Layer 初始化完成之后调用该接口设置对应的图层是否加载完毕。
|
Layer | |
![]() |
showHandler(event:FlexEvent):void
[Override] 处理 FlexEvent.SHOW 事件的侦听器函数。
|
TiledLayer | |
![]() |
viewBoundsChangedHandler(event:ViewBoundsEvent):void
[Override] 处理 viewBoundsChanged 事件的侦听器函数。
|
TiledLayer | |
![]() |
zoomEndHandler(event:ZoomEvent):void
[Override] 处理 zoomEnd 事件的侦听器函数。
|
TiledLayer | |
![]() |
zoomStartHandler(event:ZoomEvent):void
[Override] 处理 zoomStart 事件的侦听器函数。
|
TiledLayer | |
![]() |
zoomUpdateHandler(event:ZoomEvent):void
[Override] 处理 zoomUpdate 事件的侦听器函数。
|
TiledLayer |
adjustFactor | 属性 |
adjustFactor:Number
获取或设置地图坐标比例因子,取值范围大于0,建议在 1 附近取值。如果发现图层叠加时有偏移,可通过该属性移动图层,使图层正确叠加。
public function get adjustFactor():Number
public function set adjustFactor(value:Number):void
clipRegion | 属性 |
clipRegion:GeoRegion
剪裁多边形。指定该属性后,当前图层仅显示该多边形内的地图。
public function get clipRegion():GeoRegion
public function set clipRegion(value:GeoRegion):void
customServiceParams | 属性 |
customServiceParams:Object
获取或设置用户参数,如 DynamicRESTLayer.customServiceParams.angle = 90,用于设置当前图层的旋转角度.
本客户端产品中所指的图层等同于服务器产品的地图 Map,SuperMap iServer Java 6R 服务器产品在 Map 中提供了多种有关地图的属性,若本客户端产品中的图层未提供某些属性,用户即可用 customServiceParams 进行设置(如:DynamicRESTLayer.customServiceParams.angle = 90),系统内部会自动将参数传递到服务端,并获取服务端返回的地图显示结果信息,在客户端进行出图显示。
public function get customServiceParams():Object
public function set customServiceParams(value:Object):void
enableServerCaching | 属性 |
enableServerCaching:Boolean
获取或设置是否使用服务端的缓存,默认为 true,即使用服务端的缓存。在编辑功能时,需要将该属性设为 false,否则影响编辑后的显示效果。
public function get enableServerCaching():Boolean
public function set enableServerCaching(value:Boolean):void
isScaleCentric | 属性 |
isScaleCentric:Boolean
[read-only] [Override]
指示该图层是否有 DPI 值,ture 表示当前图层已根据从 SuperMap iServer 服务端获取的参数计算出 DPI;false 反之。WMS、WMTS 等图层该属性值为 false。DynamicRESTLayer、TiledDynamicRESTLayer 等专门关联 SuperMap iServer 服务的图层该属性为 true。
public function get isScaleCentric():Boolean
layersID | 属性 |
layersID:String
图层 ID ,可以是临时图层集,也可以是当前地图中图层的组合。如果此参数缺省则对全部图层进行切片...
layersID 作为临时图层集 ID 使用:例如服务端生成的专题图以资源的形式存储,每个资源都会有一个 ID 号,将资源的 ID 号赋值于该属性是在客户端显示专题图的关键步骤,如 layersID=382139acf0。
layersID 作为当前图层中的某些子图层的 ID 编号使用时,可控制子图层的可见性,此时 layersID 的定义规则如下:
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及其所有子图层。
例如,进入http://local:8090/iserver/services/maps/rest/maps/World/layers资源,显示出顶级图层 World(如下图),点击进入World资源下,可见顶级图层下包含多个子图层:
如果只显示 World 图层下的 OceanLabel_C@World@@World 子图层,则 layersID = [0:0]。
public function get layersID():String
public function set layersID(value:String):void
maxVisibleVertex | 属性 |
maxVisibleVertex:int
获取或设置最大几何对象可见节点数。如果图层中的某个几何对象的节点数超过指定的个数,则超过的那部分节点不显示。
public function get maxVisibleVertex():int
public function set maxVisibleVertex(value:int):void
overlapDisplayed | 属性 |
overlapDisplayed:Boolean
地图对象在同一范围内时,是否重叠显示,默认为false。
public function get overlapDisplayed():Boolean
public function set overlapDisplayed(value:Boolean):void
overlapDisplayedOptions | 属性 |
overlapDisplayedOptions:OverlapDisplayedOptions
避免地图对象压盖显示的过滤选项,当 overlapDisplayed为 false 时有效,用来增强对地图对象压盖时的处理。
public function get overlapDisplayedOptions():OverlapDisplayedOptions
public function set overlapDisplayedOptions(value:OverlapDisplayedOptions):void
redirect | 属性 |
redirect:Boolean
是否重定向,HTTP传输中的一个概念。如果为true,则将请求重定向到图片的真实地址;如果为false,则响应体中是图片的字节流。默认为false,不进行重定向。
public function get redirect():Boolean
public function set redirect(value:Boolean):void
tileversion | 属性 |
tileversion:String
指定请求瓦片的版本号。
public function get tileversion():String
public function set tileversion(value:String):void
url | 属性 |
url:String
[Override]
图层所在的服务地址。
public function get url():String
public function set url(value:String):void
urls | 属性 |
urls:Array
TiledDynamicRESTLayer轮询出图服务地址
此属性可用作数据绑定的源。修改此属性后,将调度 Bindable 事件。
public function get urls():Array
public function set urls(value:Array):void
TiledDynamicRESTLayer | () | 构造函数 |
public function TiledDynamicRESTLayer()
初始化 TiledDynamicRESTLayer 类的新实例。
getTileURL | () | 方法 |
override protected function getTileURL(row:int, col:int, resolution:Number):URLRequest
获取指定图片块在服务器端的存放地址。
参数
row:int — 指定图片块在整幅图层中的行号。 |
|
col:int — 指定图片块在整幅图层中的列号。 |
|
resolution:Number — 指定图片块的显示分辨率。 |
URLRequest — 返回指定图片块在服务器端的存放地址。 |
refresh | () | 方法 |
override public function refresh():void
刷新图层,即调用 Layer.invalidateDisplayList() 方法(详情请参见 Flex SDK UIComponent.invalidateDisplayList() 方法),更新 Layer 的显示列表。对于 GraphicsLayer 调用该方法会对 GraphicsLayer 上所有显示对象 Graphic 进行重绘。