MapGISTileServerImageryProvider

类名 MapGISTileServerImageryProvider

# new MapGISTileServerImageryProvider(options)

MapGIS瓦片图层

参数:

名称	类型	默认值	描述
`options`	Object
`url`	String		服务地址，格式如下： 1、IGS1.0服务基地址：http://{ip}:{port}/igs/rest/mrms/tile/{文件夹名(可选)}:{serviceName}/{level}/{row}/{col} 2、IGS2.0服务基地址：http://{ip}:{port}/arcgis/rest/services/{文件夹名(可选)}/{服务名}/TileServer
`mapStyle`	String		瓦片地图样式
`imageVersion`	String	'0'	瓦片影像版本
`tileWidth`	number	256	请求瓦片宽度
`tileHeight`	number	256	请求瓦片高度
`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
`mapgisOffset`	Number	0	瓦片错级参数，默认为0
`proxy`	String		转发代理
`extensions`	Array		扩展参数，需要确保服务端支持
`buildImageResource`	function		重载buildImageResource方法，来重载瓦片的请求逻辑

请参考以下示例:
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)
})

成员变量

类型: Credit

# readonly credit

获取此图像提供程序处于活动状态时要显示的凭证

类型: Boolean

# readonly hasAlphaChannel

是否包含alpha通道，如果此属性为false，则alpha通道（如果存在）将被忽略。如果此属性为真，任何没有alpha 通道的图像将被视为它们的alpha在任何地方都是1.0。当此属性为false时，内存使用和纹理上传时间会减少

Default Value:

true

类型: Boolean

# readonly hasAlphaChannel

Default Value:

true

类型: Boolean | undefined

# isStretchImage

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

Default Value:

false

类型: Number

# readonly mapgisOffset

瓦片错级参数

类型: Number

# readonly maximumLevel

瓦片最大级别

类型: Number

# readonly minimumLevel

瓦片最小级别

类型: Proxy

# readonly proxy

获取代理

类型: Boolean

# readonly ready

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

类型: Rectangle

# readonly rectangle

地图加载范围

类型: Number

# readonly tileHeight

瓦片高度

类型: Number

# readonly tileWidth

瓦片宽度

类型: TilingScheme

# readonly tilingScheme

瓦片平铺方案

类型: String

# readonly url

服务地址

方法

# async static fromUrl(url, options)

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

参数:

名称	类型	描述
`url`	String	服务的基地址
`options`	Object	实例化对象时提供的额外配置参数，若该对象中包含构造参数则会覆盖对应的构造参数

返回值:

初始化完毕的MapGISTileServerImageryProvider对象

类型: Cesium.MapGISTileServerImageryProvider

# pickFeatures(x, y, level)

获取瓦片内要素

参数:

名称	类型	描述
`x`	Number	瓦片的X坐标
`y`	Number	瓦片的Y坐标
`level`	Number	瓦片的详细级别

返回值:

所选要素的Promise，将在异步选择完成后resolve 解析后的值是ImageryLayerFeatureInfo的实例数组。如果在给定位置没有找到要素，则数组可能为空

类型: Promise.<Array.<ImageryLayerFeatureInfo>> | undefined

# requestImage(x, y, level, request)

请求给定瓦片的图像

参数:

名称	类型	描述
`x`	Number	瓦片的X坐标
`y`	Number	瓦片的Y坐标
`level`	Number	瓦片的详细级别
`request`	Object	请求对象

返回值:

瓦片的Resource对象

类型: Object

构造函数

成员变量

方法

事件

MapGIS Client for JavaScript API

# new MapGISTileServerImageryProvider(options)

参数:

支持如下方法：

示例

成员变量

# readonly credit

# readonly hasAlphaChannel

# readonly hasAlphaChannel

# isStretchImage

# readonly mapgisOffset

# readonly maximumLevel

# readonly minimumLevel

# readonly proxy

# readonly ready

# readonly rectangle

# readonly tileHeight

# readonly tileWidth

# readonly tilingScheme

# readonly url

方法

# async static fromUrl(url, options)

参数:

# pickFeatures(x, y, level)

参数:

# requestImage(x, y, level, request)

参数: