提供由
WMTS 1.0.0
兼容服务器提供的平铺图像。该提供程序支持HTTP KVP编码和RESTful GetTile请求,但尚不支持SOAP编码。
Name | Type | Description |
---|---|---|
options
|
WebMapTileServiceImageryProvider.ConstructorOptions | 描述初始化选项的对象 |
Examples:
// Example 1. USGS shaded relief tiles (KVP)
var shadedRelief1 = new LSGlobe.WebMapTileServiceImageryProvider({
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 LSGlobe.Credit('U. S. Geological Survey')
});
viewer.imageryLayers.addImageryProvider(shadedRelief1);
// Example 2. USGS shaded relief tiles (RESTful)
var shadedRelief2 = new LSGlobe.WebMapTileServiceImageryProvider({
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 LSGlobe.Credit('U. S. Geological Survey')
});
viewer.imageryLayers.addImageryProvider(shadedRelief2);
// Example 3. NASA time dynamic weather data (RESTful)
var times = LSGlobe.TimeIntervalCollection.fromIso8601({
iso8601: '2015-07-30/2017-06-16/P1D',
dataCallback: function dataCallback(interval, index) {
return {
Time: LSGlobe.JulianDate.toIso8601(interval.start)
};
}
});
var weather = new LSGlobe.WebMapTileServiceImageryProvider({
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 LSGlobe.Credit('NASA Global Imagery Browse Services for EOSDIS')
});
viewer.imageryLayers.addImageryProvider(weather);
Demo:
See:
Members
获取或设置一个时钟,该时钟用于获取保留用于时间动态参数的时间。
readonly credit : Credit
获取此图像提供者处于活动状态时要显示的功劳。通常,这用于记入图像的来源。在
WebMapTileServiceImageryProvider#ready
返回true之前,不应调用此函数。
此提供程序的默认alpha混合值,其中0.0表示完全透明,1.0表示完全不透明。
-
Default Value:
undefined
此提供程序的默认亮度。 1.0使用未修改的图像颜色。小于1.0使图像更暗,而大于1.0则使图像更亮。
-
Default Value:
undefined
此提供程序的默认对比。 1.0使用未修改的图像颜色。小于1.0减少大于1.0时,对比度增加。
-
Default Value:
undefined
此提供程序的全球日期的默认alpha混合值,其中0.0表示完全透明,1.0表示完全不透明。
-
Default Value:
undefined
适用于此提供程序的默认伽玛校正。 1.0使用未修改的图像颜色。
-
Default Value:
undefined
此提供程序的默认色调(以弧度为单位)。 0.0使用未修改的图像颜色。
-
Default Value:
undefined
defaultMagnificationFilter : TextureMagnificationFilter
应用于该提供程序的默认纹理放大滤镜。
-
Default Value:
undefined
defaultMinificationFilter : TextureMinificationFilter
应用于该提供程序的默认纹理缩小过滤器。
-
Default Value:
undefined
此提供程序的地球仪夜间的默认alpha混合值,其中0.0表示完全透明,1.0表示完全不透明。
-
Default Value:
undefined
此提供程序的默认饱和度。 1.0使用未修改的图像颜色。小于1.0会降低饱和度大于1.0时会增加饱和度。
-
Default Value:
undefined
获取或设置一个包含静态尺寸及其值的对象。
readonly errorEvent : Event
获取当图像提供程序遇到异步错误时引发的事件。通过订阅针对该事件,您将收到有关该错误的通知,并有可能从中恢复。事件监听器传递了
TileProviderError
的实例。
获取此图像提供程序返回的图像的MIME类型。
获取一个值,该值指示此图像提供者是否提供了图像包括一个Alpha通道。如果此属性为false,则Alpha通道(如果存在)将被忽略。如果此属性为true,则将处理任何没有alpha通道的图像好像他们的alpha到处都是1.0。当此属性为false时,内存使用情况并且减少了纹理上载时间。
获取可以请求的最大详细程度。该功能应在
WebMapTileServiceImageryProvider#ready
返回true之前不会被调用。
获取可以请求的最低详细程度。该功能应在
WebMapTileServiceImageryProvider#ready
返回true之前不会被调用。
readonly proxy : Proxy
获取此提供程序使用的代理。
获取一个值,该值指示提供者是否已准备好使用。
获取一个在提供程序准备好使用时解析为true的承诺。
readonly rectangle : Rectangle
获取此实例提供的图像的矩形(以弧度表示)。该功能应在
WebMapTileServiceImageryProvider#ready
返回true之前不会被调用。
readonly tileDiscardPolicy : TileDiscardPolicy
获取切片丢弃策略。如果未定义,则丢弃策略负责用于通过其shouldDiscardImage函数过滤掉'缺失'的图块。如果这个功能返回未定义,不过滤任何图块。该功能应在
WebMapTileServiceImageryProvider#ready
返回true之前不会被调用。
获取每个图块的高度,以像素为单位。该功能应在
WebMapTileServiceImageryProvider#ready
返回true之前不会被调用。
获取每个图块的宽度,以像素为单位。该功能应在
WebMapTileServiceImageryProvider#ready
返回true之前不会被调用。
readonly tilingScheme : TilingScheme
获取此提供程序使用的切片方案。该功能应在
WebMapTileServiceImageryProvider#ready
返回true之前不会被调用。
获取或设置一个时间间隔集合,该集合用于获取时间动态参数。每个的数据TimeInterval是一个对象,其中包含在操作过程中使用的属性的键和值平铺请求。
获取托管图像的服务的URL。
Methods
getTileCredits (x, y, level) → Array.< Credit >
获取显示给定图块时要显示的信用。
Name | Type | Description |
---|---|---|
x
|
Number | 瓦片X坐标。 |
y
|
Number | 瓷砖的Y坐标。 |
level
|
Number | 平铺级别; |
Returns:
显示图块时要显示的积分。
Throws:
-
DeveloperError :
getTileCredits
影像提供者准备就绪之前,不得调用它。
pickFeatures (x, y, level, longitude, latitude) → Promise.<Array.< ImageryLayerFeatureInfo >>|undefined
该图像提供者当前不支持拾取功能,因此该函数仅返回未定义。
Name | Type | Description |
---|---|---|
x
|
Number | 瓦片X坐标。 |
y
|
Number | 瓷砖的Y坐标。 |
level
|
Number | 平铺级别。 |
longitude
|
Number | 选择要素的经度。 |
latitude
|
Number | 选择要素的纬度。 |
Returns:
对所选择功能的承诺将在异步时解决 采摘完成。解析值是一个数组
ImageryLayerFeatureInfo
实例。如果在给定位置找不到要素,则数组可能为空。 如果不支持拣配,则它也可能是未定义的。
请求给定图块的图像。该功能应在
WebMapTileServiceImageryProvider#ready
返回true之前不会被调用。
Name | Type | Description |
---|---|---|
x
|
Number | 瓦片X坐标。 |
y
|
Number | 瓷砖的Y坐标。 |
level
|
Number | 平铺级别。 |
request
|
Request | 可选 请求对象。仅供内部使用。 |
Returns:
对图像的承诺,将在图像可用时解决,或者 如果对服务器的活动请求过多,并且请求过多,则不确定 应稍后重试。解析的图像可能是 图片或Canvas DOM对象。
Throws:
-
DeveloperError :
requestImage
影像提供者准备就绪之前,不得调用它。
Type Definitions
WebMapTileServiceImageryProvider构造函数的初始化选项
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
url
|
Resource | String | WMTS GetTile操作的基本URL(用于KVP编码的请求)或tile-URL模板(用于RESTful请求)。 tile-URL模板应包含以下变量:{style},{TileMatrixSet},{TileMatrix},{TileRow},{TileCol}。如果实际值是硬编码的或服务器不需要,则前两个是可选的。 {s}关键字可用于指定子域。 | ||
format
|
String |
<optional>
|
'image/jpeg' | 要从服务器检索的图像的MIME类型。 |
layer
|
String | WMTS请求的层名称。 | ||
style
|
String | WMTS请求的样式名称。 | ||
tileMatrixSetID
|
String | 用于WMTS请求的TileMatrixSet的标识符。 | ||
tileMatrixLabels
|
Array |
<optional>
|
TileMatrix中用于WMTS请求的标识符列表,每个TileMatrix级别一个。 | |
clock
|
Clock |
<optional>
|
一个Clock实例,用于确定时间维度的值。指定`times'时必需。 | |
times
|
TimeIntervalCollection |
<optional>
|
TimeIntervalCollection及其
data
属性是一个包含时间动态维度及其值的对象。
|
|
dimensions
|
Object |
<optional>
|
包含静态尺寸及其值的对象。 | |
tileWidth
|
Number |
<optional>
|
256 | 图块宽度(以像素为单位)。 |
tileHeight
|
Number |
<optional>
|
256 | 图块高度(以像素为单位)。 |
tilingScheme
|
TilingScheme |
<optional>
|
切片方案,与TileMatrixSet中的切片组织相对应。 | |
rectangle
|
Rectangle |
<optional>
|
Rectangle.MAX_VALUE | 由图层覆盖的矩形。 |
minimumLevel
|
Number |
<optional>
|
0 | 图像提供商所支持的最低详细程度。 |
maximumLevel
|
Number |
<optional>
|
图像提供者支持的最大详细程度,如果没有限制,则未定义。 | |
ellipsoid
|
Ellipsoid |
<optional>
|
椭球。如果未指定,则使用WGS84椭球。 | |
credit
|
Credit | String |
<optional>
|
数据源的信用,显示在画布上。 | |
subdomains
|
String | Array.<String> |
<optional>
|
'abc' |
URL模板中用于
{s}
占位符的子域。 如果此参数是单个字符串,则字符串中的每个字符都是一个子域。如果是 一个数组,数组中的每个元素都是一个子域。
|