MapLoaderWMTS

MapLoaderWMTS

WMTS 1.0.0瓦片加载器。 该加载器支持HTTP KVP编码和RESTful GetTile请求，但尚不支持SOAP编码。

Constructor

new MapLoaderWMTS(options)

Author:
  • zpc
Examples
// 例1：USGS shaded relief tiles (KVP)
var shadedRelief1 = new MapLoaderWMTS({
    url : 'http://basemap.nationalmap.gov/arcgis/rest/services/USGSShadedReliefOnly/MapServer/WMTS',
    layer : 'USGSShadedReliefOnly',
    style : 'default',
    format : 'image/jpeg',
    tileMatrixSetID : 'default028mm',
    // tileMatrixLabels : ['default028mm:0', 'default028mm:1', 'default028mm:2' ...],
    maximumLevel: 19,
    credit : new Cesium.Credit('U. S. Geological Survey')
});
mainControl.mapLayers.addTileLoader("USGS Shaded Relief KVP", shadedRelief1);
// 例2： USGS shaded relief tiles (RESTful)
var shadedRelief2 = new MapLoaderWMTS({
    url : 'http://basemap.nationalmap.gov/arcgis/rest/services/USGSShadedReliefOnly/MapServer/WMTS/tile/1.0.0/USGSShadedReliefOnly/{Style}/{TileMatrixSet}/{TileMatrix}/{TileRow}/{TileCol}.jpg',
    layer : 'USGSShadedReliefOnly',
    style : 'default',
    format : 'image/jpeg',
    tileMatrixSetID : 'default028mm',
    maximumLevel: 19,
    credit : new Cesium.Credit('U. S. Geological Survey')
});
mainControl.mapLayers.addTileLoader("USGS Shaded Relief RESTful", shadedRelief2);
// 例3：NASA时间动态天气数据 (RESTful)
var times = Cesium.TimeIntervalCollection.fromIso8601({
    iso8601: '2015-07-30/2017-06-16/P1D',
    dataCallback: function dataCallback(interval, index) {
        return {
            Time: Cesium.JulianDate.toIso8601(interval.start)
        };
    }
});
var weather = new MapLoaderWMTS({
    url : 'https://gibs.earthdata.nasa.gov/wmts/epsg4326/best/AMSR2_Snow_Water_Equivalent/default/{Time}/{TileMatrixSet}/{TileMatrix}/{TileRow}/{TileCol}.png',
    layer : 'AMSR2_Snow_Water_Equivalent',
    style : 'default',
    tileMatrixSetID : '2km',
    maximumLevel : 5,
    format : 'image/png',
    clock: clock,
    times: times,
    credit : new Cesium.Credit('NASA Global Imagery Browse Services for EOSDIS')
});
mainControl.mapLayers.addTileLoader("NASA 时间动态天气数据", weather);
Parameters:
Name Type Description
options Object 此对象拥有以下属性：
Properties
Name Type Attributes Default Description
id String <optional>
 该地图加载器的ID。
name String <optional>
 该地图加载器的名称。
url Cesium.Resource | String WMTS GetTile请求（用于KVP编码的请求）或tile-URL模板（用于RESTful请求）等基本URL。
format String <optional>
 'image/jpeg' 从服务器检索图像的MIME类型。
layer String WMTS请求的图层名称。
style String WMTS请求的样式名。
tileMatrixSetID String 用于WMTS请求的TileMatrixSet的标识符。
tileMatrixLabels Array <optional>
 TileMatrix中用于WMTS请求的标识符列表，每个TileMatrix级别一个。
clock Cesium.Clock <optional>
 确定时间维度的值时使用的Clock实例。 当指定options.times时是必需的。
times Cesium.TimeIntervalCollection <optional>
 TimeIntervalCollection及其data属性是一个包含时间动态维度及其值的对象。
dimensions Object <optional>
 包含静态尺寸及其值的对象。
tileWidth Number <optional>
 256 瓦片宽。
tileHeight Number <optional>
 256 瓦片高。
tilingScheme Cesium.TilingScheme <optional>
 new Cesium.WebMercatorTilingScheme() 切片方案与TileMatrixSet中的切片组织相对应。
rectangle Cesium.Rectangle <optional>
 Cesium.Rectangle.MAX_VALUE 地图矩形范围。
minimumLevel Number <optional>
 0 最小级别。
maximumLevel Number <optional>
 最大级别，如果没有限制，则为未定义。。
ellipsoid Cesium.Ellipsoid <optional>
 椭球。 如果未指定，则使用WGS84椭球。
credit Cesium.Credit | String <optional>
 数据源的版权，它显示在画布上。
subdomains String | Array.<String> <optional>
 'abc' URL模板中用于 {s} 占位符的子域。 如果此参数是单个字符串，则字符串中的每个字符都是一个子域。 如果是数组，则数组中的每个元素都是一个子域。

Extends

Members

clock :Cesium.Clock

获取或设置一个时钟，该时钟用于获取保留用于时间动态参数的时间。
Type:
  • Cesium.Clock

(readonly) credit :Cesium.Credit

Overrides:
获取版权信息。 在 MapLoader#ready 返回true之前，不应调用此函数。
Type:
  • Cesium.Credit

dimensions :Object

获取或设置一个包含静态尺寸及其值的对象。
Type:
  • Object

(readonly) errorEvent :Cesium.Event

Overrides:
获取此加载器遇到异步错误时触发的事件。
Type:
  • Cesium.Event

(readonly) format :String

获取此图像提供程序返回的图像的MIME类型。
Type:
  • String

(readonly) hasAlphaChannel :Boolean

Overrides:
获取影像是否有Alpha通道。
Type:
  • Boolean

(readonly) id :String

Overrides:
获取ID。
Type:
  • String

(readonly) maximumLevel :Number

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

(readonly) minimumLevel :Number

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

(readonly) provider :Boolean

Overrides:
获取此瓦片加载器包装的图形提供器。
Type:
  • Boolean

(readonly) proxy :Cesium.Proxy

Overrides:
获取此加载器使用的代理。
Type:
  • Cesium.Proxy

(readonly) ready :Boolean

Overrides:
获取加载器是否已准备好。
Type:
  • Boolean

(readonly) readyPromise :Promise.<Boolean>

Overrides:
获取在加载器准备就绪时可以解析为true的Promise。
Type:
  • Promise.<Boolean>

(readonly) rectangle :Cesium.Rectangle

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

(readonly) tileDiscardPolicy :Cesium.TileDiscardPolicy

Overrides:
获取瓦片丢弃策略。 在 MapLoader#ready 返回true之前，不应调用此函数。
Type:
  • Cesium.TileDiscardPolicy

(readonly) tileHeight :Number

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

(readonly) tileWidth :Number

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

(readonly) tilingScheme :Cesium.TilingScheme

Overrides:
获取切片方案。 在 MapLoader#ready 返回true之前，不应调用此函数。
Type:
  • Cesium.TilingScheme

times :Cesium.TimeIntervalCollection

获取或设置一个时间间隔集合，该集合用于获取时间动态参数。每个的数据 TimeInterval是一个对象，其中包含切片请求期间使用的属性的键和值。
Type:
  • Cesium.TimeIntervalCollection

(readonly) url :String

获取WMTS服务器的URL。
Type:
  • String

Methods

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

Overrides:
获取当请求的瓦片被显示出来时，要显示的版权信息。
Parameters:
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的层级。
Throws:
在图像提供器准备就绪之前，不得调用 getTileCredits 。
Type
Cesium.DeveloperError
Returns:
返回的版权。
Type
Array.<Cesium.Credit>

pickFeatures(x, y, level, longitude, latitude) → {Promise.<Array.<Cesium.ImageryLayerFeatureInfo>>|undefined}

这个图像提供器目前不支持拾取功能，所以这个函数只是返回未定义。
Parameters:
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的级别。
longitude Number 拾取要素的经度。
latitude Number 拾取要素的纬度。
Returns:
对所选要素的promise，它将在异步拾取完成时解析。 解析后的值是Cesium.ImageryLayerFeatureInfo实例的数组。如果在给定位置没有发现任何要素，则该数组可能为空。 如果不支持拾取，它也可能是未定义的。
Type
Promise.<Array.<Cesium.ImageryLayerFeatureInfo>> | undefined

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

Overrides:
请求给定块的瓦片。MapLoaderWMTS#ready返回true之前，不应调用此函数。
Parameters:
Name Type Attributes Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的层级。
request Cesium.Request <optional>
 Request对象（仅供内部使用）。
Throws:
准备好图像提供器之前，不得调用 requestImage 。
Type
Cesium.DeveloperError
Returns:
返回值有以下3种情况： 1.当图像可用时，返回对图像的Promise。 2.如果有太多对服务器的活动请求，则返回未定义图像，并且应该稍后重新请求。 3.解析后的图像可以是图像，也可以是画布DOM对象。
Type
Promise.<(Image|Canvas)> | undefined