MapGISTileServerImageryProvider

类名 MapGISTileServerImageryProvider

# new MapGISTileServerImageryProvider(options)

IGS瓦片服务接入类

参数:

名称	类型	默认值	描述
`options`	Object
`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
`proxy`	String		转发代理
`buildImageResource`	function		重载buildImageResource方法，来重载瓦片的请求逻辑
`extensions`	Array.<Object>	[]	扩展参数，计划废弃，会将扩展参数中的非空参数拼接到请求接口上，SDK不会对扩展参数进行加密，示例：[{ key: '参数名', value: '参数值' }]，计划废弃，推荐设置到Cesium.Resource中

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

支持如下方法：

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

示例

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

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

// 定义瓦片地图服务的基地址
const url = 'http://webclient.smaryun.com: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://webclient.smaryun.com: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)
})

成员变量

类型: Boolean | undefined

# isStretchImage

超过最大最小层级范围图像是否进行图像的拉伸

Default Value:

false

类型: Boolean

# readonly ready

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

方法

# async static fromUrl(url, options)

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

参数:

名称	类型	描述
`url`	Cesium.Resource \| String	服务的基地址，支持url字符串和Cesium.Resource两种类型，当类型为Cesium.Resource时，支持传入额外请求参数、请求头参数等，具体请参考Cesium.Resource
`options`	Object	实例化对象时提供的额外配置参数，若该对象中包含构造参数则会覆盖对应的构造参数