Class: MapGISTileServerImageryProvider

MapGISTileServerImageryProvider

new MapGISTileServerImageryProvider(options)

engineExtensions/scene/imageryProvider/MapGISTileServerImageryProvider.js, line 12

请参考以下示例:
1、添加一个MapGIS瓦片图层:原生接口
2、添加一个MapGIS瓦片图层:混合接口
3、影像图层高程模式设置
4、卷帘
5、地表透明度独立控制
6、更多图层加载示例

支持如下方法:
[1、通过MapGIS瓦片服务的url获取MapGISTileServerImageryProvider对象]
[2、请求给定瓦片的图像]
[3、获取瓦片内要素]

IGS瓦片服务接入类

Name Type Description
options Object
Name Type Default Description
url Cesium.Resource | String

服务的基地址,支持url字符串和Cesium.Resource两种类型,当类型为Cesium.Resource时,支持传入额外请求参数、请求头参数等,具体请参考Cesium.Resource
格式如下:
1、IGS1.0服务基地址:http://{ip}:{port}/igs/rest/mrms/tile/{folder}:{serviceName}
2、IGS2.0服务基地址:http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/TileServer
3、IGS2.0服务基地址:http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/MapServer

minimumLevel number 0 可选

图层最小请求瓦片级别,小于该级别不再请求瓦片

maximumLevel number 可选

图层最大请求瓦片级别,大于该级别不再请求瓦片

isStretchImage Boolean false 可选

超过最大最小层级范围图像是否进行图像的拉伸。此值未定义或者设置为true时,如果图像level小于minimumLevel或者大于maximumLevel,图像会进行拉伸。反之,如果图像level小于minimumLevel或者大于maximumLevel,不会再请求图像以及拉伸图像

tilingScheme Cesium.TilingScheme | CustomTilingScheme Cesium.GeographicTilingScheme 可选

瓦片服务的平铺方案,详见Cesium.TilingScheme

rectangle Cesium.Rectangle Cesium.Rectangle.MAX_VALUE 可选

图层显示范围,超出范围不会额外请求瓦片,详见Cesium.Rectangle

isStretchImage Boolean true 可选

“视图的显示级别,超出瓦片数据自身支持的级别”时,是否对瓦片进行拉伸显示。此值未定义或者设置为true时,超出范围后,会采用最接近一级的瓦片进行拉伸或缩放显示。反之,超出范围后,瓦片不再显示

proxy String 可选

转发代理

buildImageResource function 可选

重载buildImageResource方法,来重载瓦片的请求逻辑

extensions Array.<Object> [] 可选

扩展参数,计划废弃,会将扩展参数中的非空参数拼接到请求接口上,SDK不会对扩展参数进行加密,示例:[{ key: '参数名', value: '参数值' }],计划废弃,推荐设置到Cesium.Resource中

Examples

添加一个MapGIS瓦片图层:原生接口

// ES5引入方式
const { MapGISTileServerImageryProvider } = zondy.cesium
// ES6引入方式
import { MapGISTileServerImageryProvider } from "@mapgis/webclient-cesium-plugin"

// 定义瓦片地图服务的基地址
const url = 'http://10.10.130.72:8089/igs/rest/services/Tile/%E6%AD%A6%E6%B1%89%E5%B8%82_4547_custom_1-10/TileServer'

// 加载IGS二维瓦片地图服务
async function addTileLayer() {
  const provider = await MapGISTileServerImageryProvider.fromUrl(url)
  viewer.imageryLayers.addImageryProvider(provider)
}

//添加栅格图层
addTileLayer()

添加一个MapGIS瓦片图层:混合接口

// ES5引入方式
const { MapGISTileServerImageryProvider } = zondy.cesium
const { IGSTileLayer } = zondy.layer
const { initializeOptions } = zondy.cesium.util
// ES6引入方式
import { initializeOptions, MapGISTileServerImageryProvider } from "@mapgis/webclient-cesium-plugin"
import { IGSTileLayer } from "@mapgis/webclient-common"

// 定义瓦片地图服务的基地址
const url = 'http://10.10.130.72:8089/igs/rest/services/Tile/%E6%AD%A6%E6%B1%89%E5%B8%82_4547_custom_1-10/TileServer'

// 创建瓦片地图图层对象
const igsTileLayer = new IGSTileLayer({ url })

// 获取瓦片图层服务的元信息
igsTileLayer.load().then((layer) => {
  // 获取provider的初始化参数
  const options = initializeOptions(layer, viewer)
  // 构造provider对象
  provider = new MapGISTileServerImageryProvider(options)
  // 添加图层到Cesium视图中
  cesiumLayer = viewer.imageryLayers.addImageryProvider(provider)
})

Members

isStretchImageBoolean undefined

“视图的显示级别,超出瓦片数据自身支持的级别”时,是否对瓦片进行拉伸显示。此值未定义或者设置为true时,超出范围后,会采用最接近一级的瓦片进行拉伸或缩放显示。反之,超出范围后,瓦片不再显示

Default Value:
true

readyBoolean

获取当前图层是否创建完成

Methods

MapGISTileServerImageryProvider.fromUrl(url, options){Cesium.MapGISTileServerImageryProvider}

engineExtensions/scene/imageryProvider/MapGISTileServerImageryProvider.js, line 147

通过MapGIS瓦片服务的url获取MapGISTileServerImageryProvider对象

Name Type Description
url Cesium.Resource | String

服务的基地址,支持url字符串和Cesium.Resource两种类型,当类型为Cesium.Resource时,支持传入额外请求参数、请求头参数等,具体请参考Cesium.Resource

options Object

实例化对象时提供的额外配置参数,若该对象中包含构造参数则会覆盖对应的构造参数

Returns:
Type Description
Cesium.MapGISTileServerImageryProvider 初始化完毕的MapGISTileServerImageryProvider对象

requestImage(x, y, level, request){Object}

engineExtensions/scene/imageryProvider/MapGISTileServerImageryProvider.js, line 201
Name Type Description
x Number

瓦片的X坐标

y Number

瓦片的Y坐标

level Number

瓦片的详细级别

request Object

请求对象

Returns:
Type Description
Object 瓦片的Resource对象