Class: TiledMapLayer

TiledMapLayer

SuperMap iServer 的 REST 地图服务的图层(SuperMap iServer Java 6R 及以上分块动态 REST 图层)。使用 TileImage 资源出图。

new TiledMapLayer(url, options)

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

// ES6 Import
import { TiledMapLayer } from '@supermap/iclient-leaflet';

new TiledMapLayer(url, options);

leaflet/mapping/TiledMapLayer.js, line 14
Name Type Description
url string

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

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 可选

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

tileversion string 可选

切片版本名称,cacheEnabled 为 true 时有效。如果没有设置 tileversion 参数,而且当前地图的切片集中存在多个版本,则默认使用最后一个更新版本。

crs CRS 可选

坐标系统类。

tileProxy string 可选

服务代理地址。

format string 'png' 可选

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

tileSize number | L.Point 256 可选

瓦片大小。

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>' 可选

版权信息。

subdomains Array.<number> 可选

子域名数组。

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

Extends

Events

tilesetsinfoloaded

leaflet/mapping/TiledMapLayer.js, line 196

瓦片集信息设置完成后触发。

Properties:
Name Type Description
tileVersions Array.<Object>

瓦片集信息。

tileversionschanged

leaflet/mapping/TiledMapLayer.js, line 247

切片的版本切换和重绘成功之后触发。

Properties:
Name Type Description
tileVersion Object

该版本的切片。

Methods

changeTilesVersion()

leaflet/mapping/TiledMapLayer.js, line 225

切换到某一版本的切片,并重绘。通过 this.tempIndex 保存需要切换的版本索引

getScale(zoom){number}

leaflet/mapping/TiledMapLayer.js, line 119

根据缩放级别获取比例尺。

Name Type Description
zoom number

缩放级别。

Returns:
Type Description
number 比例尺。

getScaleFromCoords(coords){number}

leaflet/mapping/TiledMapLayer.js, line 132

通过行列号获取比例尺。

Name Type Description
coords Object

行列号。

Returns:
Type Description
number 比例尺。

getTileUrl(coords){string}

leaflet/mapping/TiledMapLayer.js, line 96

根据行列号获取瓦片地址。

Name Type Description
coords Object

行列号。

Returns:
Type Description
string 瓦片地址。

lastTilesVersion()

leaflet/mapping/TiledMapLayer.js, line 207

请求上一个版本切片,并重新绘制。

mergeTileVersionParam(version){boolean}

leaflet/mapping/TiledMapLayer.js, line 268

更改URL请求参数中的切片版本号,并重绘。

Name Type Description
version string

切片版本号。

Returns:
Type Description
boolean 是否成功。

nextTilesVersion()

leaflet/mapping/TiledMapLayer.js, line 216

请求下一个版本切片,并重新绘制。

setTileSetsInfo(tileSets)

leaflet/mapping/TiledMapLayer.js, line 183

设置瓦片集信息。

Name Type Description
tileSets Object

瓦片对象集。

updateCurrentTileSetsIndex(index)

leaflet/mapping/TiledMapLayer.js, line 259

手动设置当前切片集索引,目前主要提供给控件使用。

Name Type Description
index number

索引值。