Class: TileSuperMapRest

TileSuperMapRest

以地图瓦片的方式展示 SuperMap iServer 的 REST 地图服务的地图。它通过调用 TileImage 接口获取地图瓦片。

new TileSuperMapRest(options)

Usage
import { TileSuperMapRest } from '@supermapgis/iclient-ol';

new TileSuperMapRest(options);
<script type="text/javascript" src="https://iclient.supermap.io/dist/openlayers/iclient-ol.js"></script>
<script>
  new ol.source.TileSuperMapRest({paramsNames});
</script>
openlayers/mapping/TileSuperMapRest.js, line 54
Name Type Description
options Object

参数。

Name Type Default Description
url string

服务地址，例如: http://{ip}:{port}/iserver/services/map-world/rest/maps/World。
urls Array.<string>

服务地址数组，例如: http://{ip}:{port}/iserver/services/map-world/rest/maps/World。
tileGrid ol.tilegrid.TileGrid 可选

瓦片网格对象。当不指定时，会通过 options.extent 或投影范围生成。
redirect boolean false 可选

是否重定向。
transparent boolean true 可选

瓦片是否透明。
cacheEnabled boolean true 可选

是否使用服务端的缓存。
prjCoordSys Object 可选

请求的地图的坐标参考系统。当此参数设置的坐标系统不同于地图的原有坐标系统时，系统会进行动态投影，并返回动态投影后的地图瓦片。例如：{"epsgCode":3857}。
layersID string 可选

获取进行切片的地图图层 ID，即指定进行地图切片的图层，可以是临时图层集，也可以是当前地图中图层的组合。
clipRegionEnabled boolean false 可选

是否只地图只显示该区域覆盖的部分。true 表示地图只显示该区域覆盖的部分。
clipRegion ol.geom.Geometry 可选

地图显示裁剪的区域。是一个面对象，当 clipRegionEnabled = true 时有效，即地图只显示该区域覆盖的部分。
overlapDisplayed boolean false 可选

地图对象在同一范围内时，是否重叠显示。如果为 true，则同一范围内的对象会直接压盖；如果为 false 则通过 overlapDisplayedOptions 控制对象不压盖显示。
overlapDisplayedOptions OverlapDisplayedOptions 可选

避免地图对象压盖显示的过滤选项，当 overlapDisplayed 为 false 时有效，用来增强对地图对象压盖时的处理。
tileversion string 可选

切片版本名称，_cache 为 true 时有效。
tileProxy string 可选

服务代理地址。
format string 'png' 可选

瓦片表述类型，支持 "png" 、"webp"、"bmp" 、"jpg"、"gif" 等图片类型。
rasterfunction NDVIParameter | HillshadeParameter 可选

栅格分析参数。
displayFilters Object 可选

图层的显示过滤条件，利用该参数控制图层中可显示的要素。 参数结构： { "<layerName1>": "{displayFilter}", "<layerName2>": "{displayFilter}" } 其中， <layerName> 为地图中某图层名称，可从 layer 资源响应体参数 name 中获取； {displayFilter} 为属性过滤条件，仅对数据中存在的属性生效。 当前仅支持对工作空间数据源发布的地图进行属性过滤，支持对多图层同时过滤。
chartSetting ChartSettingS57 | ChartSettingS100 可选

海图显示参数设置类，用于管理海图显示环境，包括海图的显示模式、显示类型名称、颜色模式、安全水深线等各种显示风格。
overflowTiles number 0 可选

在当前视口范围外额外渲染的瓦片圈数。为 1 时上下左右各多请求一圈瓦片，可用于缓解符号在图层范围边缘被裁切的问题。

Extends

TileSuperMapRest -> ol.source.TileImage

Methods

static createTileGrid(extent, maxZoom, minZoom, tileSize, origin)

openlayers/mapping/TileSuperMapRest.js, line 447

创建切片网格。

Name Type Description
extent number

长度。
maxZoom number

最大的放大级别。
minZoom number

最小的放大级别。
tileSize number

瓦片的尺寸。
origin number

原点。

static optionsFromMapJSON(url, mapJSONObj)

openlayers/mapping/TileSuperMapRest.js, line 419

从 MapJSON 中获取参数对象。

Name Type Description
url string

服务地址。
mapJSONObj Object

地图 JSON 对象。

static updateParams(params)

openlayers/mapping/TileSuperMapRest.js, line 472

更新参数。

Name Type Description
params Object

参数对象。
Version:
  • 11.2.0

changeTilesVersion()

openlayers/mapping/TileSuperMapRest.js, line 364

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

createLayerUrl()

openlayers/mapping/TileSuperMapRest.js, line 231

获取新建图层地址。

getAllRequestParams()

openlayers/mapping/TileSuperMapRest.js, line 139

获取全部请求参数。

getFullRequestUrl()

openlayers/mapping/TileSuperMapRest.js, line 207

获取完整的请求地址。

lastTilesVersion()

openlayers/mapping/TileSuperMapRest.js, line 346

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

mergeTileVersionParam(version){boolean}

openlayers/mapping/TileSuperMapRest.js, line 403

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

Name Type Description
version Object

版本信息。
Returns:
Type Description
boolean 是否成功。

nextTilesVersion()

openlayers/mapping/TileSuperMapRest.js, line 355

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

setTileSetsInfo(tileSets)

openlayers/mapping/TileSuperMapRest.js, line 324

设置瓦片集信息。

Name Type Description
tileSets Object

瓦片集合。

updateCurrentTileSetsIndex(index)

openlayers/mapping/TileSuperMapRest.js, line 394

更新当前切片集索引，目前主要提供给控件使用。

Name Type Description
index number

索引号。