MapLoaderTMS

MapTiler、GDAL2Tiles等生成的切片图像的瓦片地图加载器。

Constructor

new MapLoaderTMS(optionsopt)

Author:

Example

var tms = new MapLoaderTMS({
   url : '../images/cesium_maptiler/Cesium_Logo_Color',
   fileExtension: 'png',
   maximumLevel: 4,
   rectangle: new Cesium.Rectangle(
       Cesium.Math.toRadians(-120.0),
       Cesium.Math.toRadians(20.0),
       Cesium.Math.toRadians(-60.0),
       Cesium.Math.toRadians(40.0))
});

Parameters:

Name Type Attributes Description

options

Object

此对象拥有以下属性：

Properties

Name	Type	Attributes	Default	Description
`id`	String	<optional>		该地图加载器的ID。
`name`	String	<optional>		该地图加载器的名称。
`url`	Cesium.Resource \| String \| Promise.<Cesium.Resource> \| Promise.<String>	<optional>	`'.'`	到服务器上的图像瓦片的路径。
`fileExtension`	String	<optional>	`'png'`	服务器上图像的文件扩展名。
`credit`	Cesium.Credit \| String	<optional>	`''`	数据源的版权，它显示在画布上。
`minimumLevel`	Number	<optional>	`0`	图像提供器支持的最小级别。
`maximumLevel`	Number	<optional>		图像提供器支持的最大细节级别，如果没有限制，则为未定义。
`rectangle`	Cesium.Rectangle	<optional>	`Cesium.Rectangle.MAX_VALUE`	图层的矩形范围，以弧度为单位。
`tilingScheme`	Cesium.TilingScheme	<optional>		切片方案。如果没有提供此参数，则使用`Cesium.WebMercatorTilingScheme`。
`ellipsoid`	Cesium.Ellipsoid	<optional>		椭球。如果指定了tilingScheme，则忽略该参数，而使用切片方案的椭球体。如果没有指定任何参数，则使用WGS84椭球体。
`tileWidth`	Number	<optional>	`256`	瓦片宽。
`tileHeight`	Number	<optional>	`256`	瓦片高。
`flipXY`	Boolean	<optional>		较旧的gdal2tiles.py版本在tilemapresource.xml中翻转了X和Y值。指定此选项将执行相同的操作，从而允许加载这些不正确的瓦片集。

Extends

MapLoader

Members

(readonly) credit :Cesium.Credit

Overrides:

MapLoader#credit

获取版权信息。在 MapLoader#ready 返回true之前，不应调用此函数。

Type:

Cesium.Credit

(readonly) errorEvent :Cesium.Event

Overrides:

MapLoader#errorEvent

获取此加载器遇到异步错误时触发的事件。

Type:

Cesium.Event

(readonly) fileExtension :String

TMS地图瓦片图片的文件扩展名。

Type:

String

(readonly) hasAlphaChannel :Boolean

Overrides:

MapLoader#hasAlphaChannel

获取影像是否有Alpha通道。

Type:

Boolean

(readonly) id :String

Overrides:

MapLoader#id

获取ID。

Type:

String

(readonly) maximumLevel :Number

Overrides:

MapLoader#maximumLevel

获取可以请求的最大级别。在 MapLoader#ready 返回true之前，不应调用此函数。

Type:

Number

(readonly) minimumLevel :Number

Overrides:

MapLoader#minimumLevel

获取可以请求的最小级别。在 MapLoader#ready 返回true之前，不应调用此函数。

Type:

Number

(readonly) provider :Boolean

Overrides:

MapLoader#provider

获取此瓦片加载器包装的图形提供器。

Type:

Boolean

(readonly) proxy :Cesium.Proxy

Overrides:

MapLoader#proxy

获取此加载器使用的代理。

Type:

Cesium.Proxy

(readonly) ready :Boolean

Overrides:

MapLoader#ready

获取加载器是否已准备好。

Type:

Boolean

(readonly) readyPromise :Promise.<Boolean>

Overrides:

MapLoader#readyPromise

获取在加载器准备就绪时可以解析为true的Promise。

Type:

Promise.<Boolean>

(readonly) rectangle :Cesium.Rectangle

Overrides:

MapLoader#rectangle

获取要显示的地图范围（以弧度表示）。在 MapLoader#ready 返回true之前，不应调用此函数。

Type:

Cesium.Rectangle

(readonly) tileDiscardPolicy :Cesium.TileDiscardPolicy

Overrides:

MapLoader#tileDiscardPolicy

获取瓦片丢弃策略。在 MapLoader#ready 返回true之前，不应调用此函数。

Type:

Cesium.TileDiscardPolicy

(readonly) tileHeight :Number

Overrides:

MapLoader#tileHeight

获取瓦片高，以像素为单位。在 MapLoader#ready 返回true之前，不应调用此函数。

Type:

Number

(readonly) tileWidth :Number

Overrides:

MapLoader#tileWidth

获取瓦片宽，以像素为单位。在 MapLoader#ready 返回true之前，不应调用此函数。

Type:

Number

(readonly) tilingScheme :Cesium.TilingScheme

Overrides:

MapLoader#tilingScheme

获取切片方案。在 MapLoader#ready 返回true之前，不应调用此函数。

Type:

Cesium.TilingScheme

(readonly) url :String

TMS地图瓦片服务器的URL。

Type:

String

Methods

getTileCredits(x, y, level) → {Array.<Cesium.Credit>}

Overrides:

MapLoader#getTileCredits

获取要显示的版权。在MapLoader#ready返回true之前，不应该调用此函数。

Parameters:

Name	Type	Description
`x`	Number	瓦片的X坐标。
`y`	Number	瓦片的Y坐标。
`level`	Number	瓦片的层级。

Throws:

在瓦片加载器准备好之前， getTileCredits 不能被调用。
Type Cesium.DeveloperError

Returns:

瓦片显示时要显示的版权。

Type: Array.<Cesium.Credit>

requestImage(x, y, level, requestopt) → {Promise.<(Image|Canvas)>|undefined}

Overrides:

MapLoader#requestImage

请求给定瓦片的图像。在MapLoader#ready返回true之前，不应该调用此函数。

Parameters:

Name	Type	Attributes	Description
`x`	Number		瓦片的X坐标。
`y`	Number		瓦片的Y坐标。
`level`	Number		瓦片的层级。
`request`	Cesium.Request	<optional>	Request对象（仅供内部使用）。

Throws:

在瓦片加载器准备好之前， requestImage 不能被调用。
Type DeveloperError

Returns:

请求到的结果。

Type: Promise.<(Image|Canvas)> | undefined