Class: ImageMapLayer

ImageMapLayer

SuperMap iServer 的 REST 地图服务的图层类(SuperMap iServer Java 6R 及以上分块动态 REST 图层)。使用 Image 资源出图。 此类提供了与地图显示、地图裁剪、图层设置、栅格分析等有关的参数。

new ImageMapLayer(url, options)

Usage
// 浏览器
<script type="text/javascript" src="https://iclient.supermap.io/dist/leaflet/iclient-leaflet.js"></script>
<script>
  new L.supermap.ImageMapLayer(url, options);
  
  // 弃用的写法
  L.supermap.imageMapLayer(url, options);
  
</script>

// ES6 Import
import { ImageMapLayer } from '@supermapgis/iclient-leaflet';

new ImageMapLayer(url, options);

leaflet/mapping/ImageMapLayer.js, line 11
Name Type Description
url string

服务地址,如:http://{ip}:{port}/iserver/services/map-china400/rest/maps/China。

options Object

参数。

Name Type Default Description
layersID string 可选

获取需要切片的地图图层 ID,即指定需要切片的地图图层,可以是临时图层集,也可以是当前地图中图层的组合。

redirect boolean false 可选

是否重定向,如果为 true,则将请求重定向到瓦片的真实地址;如果为 false,则响应体中是瓦片的字节流。

transparent boolean true 可选

地图瓦片是否透明。

cacheEnabled boolean true 可选

是否启用缓存。

clipRegionEnabled boolean false 可选

是否启用地图裁剪。

clipRegion L.Path 可选

地图显示裁剪的区域(区域为一个面对象)。当 clipRegionEnabled = true 时有效,即地图只显示该区域覆盖的部分。

prjCoordSys Object 可选

请求的地图的坐标参考系统。如:prjCoordSys={"epsgCode":3857}。

overlapDisplayed boolean false 可选

地图对象在同一范围内,是否重叠显示。

overlapDisplayedOptions string 可选

避免地图对象压盖显示的过滤选项。

opacity number 1 可选

图层不透明度。

alt string 可选

图像无法显示时的提示文字。

pane string 'tilePane' 可选

图层所归属的 map DOM 的分组。

interactive boolean false 可选

是否响应鼠标点击或悬停等交互事件。

crossOrigin boolean false 可选

是否设置跨域属性。

errorOverlayUrl string 可选

图层未能加载时显示的瓦片地址。

zIndex number 1 可选

设置图层的层级。

className string 可选

自定义 DOM 元素的 className。

updateInterval number 150 可选

平移时图层延迟刷新间隔时间。

tileProxy string 可选

服务代理地址。

format string 'png' 可选

瓦片表述类型,支持 "png" 、"webp"、"bmp" 、"jpg"、"gif" 等图片格式。

rasterfunction NDVIParameter | HillshadeParameter 可选

栅格分析参数。支持归一化植被指数分析参数、山体阴影分析参数。

attribution string 'Map Data <span>© <a href='http://support.supermap.com.cn/product/iServer.aspx' title='SuperMap iServer' target='_blank'>SuperMap iServer</a></span>' 可选

版权描述信息。

Fires
Example
new ImageMapLayer(url).addTo(map);

Extends

Events

error

leaflet/mapping/ImageMapLayer.js, line 289

请求图层加载失败后触发。

load

leaflet/mapping/ImageMapLayer.js, line 280

请求图层加载完成后触发。

Properties:
Name Type Description
bounds L.Bounds

图层 bounds。

loading

leaflet/mapping/ImageMapLayer.js, line 299

请求图层加载中触发。

Properties:
Name Type Description
bounds L.Bounds

图层 bounds。

Methods

bringToBack()

leaflet/mapping/ImageMapLayer.js, line 144

置底当前图层。

bringToFront()

leaflet/mapping/ImageMapLayer.js, line 132

置顶当前图层。

getImageUrl(){string}

leaflet/mapping/ImageMapLayer.js, line 177

获取 image 图层请求地址,子类可重写实现。

Returns:
Type Description
string 请求瓦片地址。

getOpacity(){number}

leaflet/mapping/ImageMapLayer.js, line 156

获取图层不透明度。

Returns:
Type Description
number 图层的不透明度。

setOpacity()

leaflet/mapping/ImageMapLayer.js, line 165

设置图层不透明度。

update()

leaflet/mapping/ImageMapLayer.js, line 307

更新图层。