提供由 Web 地图服务 (WMS) 服务器托管的切片影像。
| Name | Type | Description |
|---|---|---|
options |
WebMapServiceImageryProvider.ConstructorOptions | 描述初始化选项的对象 |
Example:
const provider = new Cesium.WebMapServiceImageryProvider({
url : 'https://sampleserver1.arcgisonline.com/ArcGIS/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/WMSServer',
layers : '0',
proxy: new Cesium.DefaultProxy('/proxy/')
});
const imageryLayer = new Cesium.ImageryLayer(provider);
viewer.imageryLayers.add(imageryLayer);See:
Members
WMS URL 中用于获取图像的默认参数。 值如下所示：
service=WMS
version=1.1.1
request=GetMap
styles=
format=image/jpeg
要包含在 WMS URL 中以获取要素信息的默认参数。 值如下所示：
service=WMS
version=1.1.1
request=GetFeatureInfo
获取或设置一个 clock，该 clock 用于 get keep time used for time 动态参数。
readonly credit : Credit
获取此影像提供程序处于活动状态时要显示的点数。 通常，这用于贷记
图像的来源。
获取或设置一个值，该值指示是否启用功能选取。 如果为 true，则
WebMapServiceImageryProvider#pickFeatures 将
调用 WMS 服务器上的 GetFeatureInfo 服务，并尝试解释响应中包含的功能。 如果为 false，则
WebMapServiceImageryProvider#pickFeatures 将立即返回 undefined(表示没有可选取的
功能)，而无需与服务器通信。 如果您知道您的数据，请将此属性设置为 false
Source 不支持选取功能，或者您不希望此提供程序的功能可选取。
-
Default Value:
true
readonly errorEvent : Event
获取在影像提供程序遇到异步错误时引发的事件。 通过订阅
时，您将收到错误通知，并可能从中恢复。 事件侦听器
将传递
TileProviderError 的实例。
readonly getFeatureInfoUrl : Resource|string
获取 WMS 服务器的 getFeatureInfo URL。
获取一个值，该值指示此图像提供程序是否提供图像
包括 Alpha 通道。 如果此属性为 false，则 Alpha 通道(如果存在)将
被忽略。 如果此属性为 true，则将处理任何没有 Alpha 通道的图像
就好像它们的 alpha 在所有地方都是 1.0 一样。 当此属性为 false 时，内存使用情况
和纹理上传时间缩短。
获取名称WMS 图层，以逗号分隔。
获取可请求的最大详细级别。
获取可请求的最小详细级别。
readonly proxy : Proxy
获取此提供程序使用的代理。
readonly rectangle : Rectangle
获取此实例提供的图像的矩形(以弧度为单位)。
readonly tileDiscardPolicy : TileDiscardPolicy
获取瓦片丢弃策略。 如果未 undefined，则 discard 策略负责
用于通过其 shouldDiscardImage 函数过滤掉“缺失”的瓦片。 如果此功能
返回 undefined，不过滤任何图块。
获取每个图块的高度(以像素为单位)。
获取每个图块的宽度(以像素为单位)。
readonly tilingScheme : TilingScheme
获取此提供程序使用的切片方案。
获取或设置用于获取时间动态参数的时间间隔集合。每个
TimeInterval 是一个对象，其中包含在
磁贴请求。
获取 WMS 服务器的 URL。
Methods
getTileCredits(x, y, level) → Array.<Credit>
获取在显示给定磁贴时要显示的积分。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片 X 坐标。 |
y |
number | 瓦片 Y 坐标。 |
level |
number | 瓦片级别; |
Returns:
显示磁贴时要显示的制作者名单。
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:
对所选特征的 Promise，当异步
拣选完成。 解析的值是
ImageryLayerFeatureInfo 的数组
实例。 如果在给定位置未找到要素，则数组可能为空。
requestImage(x, y, level, request) → Promise.<ImageryTypes>|undefined
请求给定磁贴的图像。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片 X 坐标。 |
y |
number | 瓦片 Y 坐标。 |
level |
number | 瓦片级别。 |
request |
Request | optional 请求对象。仅供内部使用。 |
Returns:
当镜像可用时将解析的镜像的 Promise，或者
undefined 如果对服务器的活动请求过多，则应稍后重试该请求。
Type Definitions
WebMapServiceImageryProvider 构造函数的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
url |
Resource | string | WMS 服务的 URL。该 URL 支持与 UrlTemplateImageryProvider 相同的关键字。 |
||
layers |
string | 要包含的图层，用逗号分隔。 | ||
parameters |
object |
<optional> |
WebMapServiceImageryProvider.DefaultParameters | 在 GetMap URL 中传递给 WMS 服务器的其他参数。 |
getFeatureInfoParameters |
object |
<optional> |
WebMapServiceImageryProvider.GetFeatureInfoDefaultParameters | 在 GetFeatureInfo URL 中传递给 WMS 服务器的其他参数。 |
enablePickFeatures |
boolean |
<optional> |
true | 如果为 true，则 WebMapServiceImageryProvider#pickFeatures 将调用
在 WMS 服务器上执行 GetFeatureInfo 操作，并返回响应中包含的要素。 如果为 false，则
WebMapServiceImageryProvider#pickFeatures 将立即返回 undefined(表示没有可选取的特征)
而不与服务器通信。 如果您知道 WMS 服务器不支持，请将此属性设置为 false
GetFeatureInfo 或者您不希望此提供商的功能是可选择的。请注意，这可以是动态的
通过修改 WebMapServiceImageryProvider#enablePickFeatures 属性进行覆盖。 |
getFeatureInfoFormats |
Array.<GetFeatureInfoFormat> |
<optional> |
WebMapServiceImageryProvider.DefaultGetFeatureInfoFormats | 格式 在其中尝试 WMS GetFeatureInfo 请求。 |
rectangle |
Rectangle |
<optional> |
Rectangle.MAX_VALUE | 图层的矩形。 |
tilingScheme |
TilingScheme |
<optional> |
new GeographicTilingScheme() | 用于将世界划分为多个图块的平铺方案。 |
ellipsoid |
Ellipsoid |
<optional> |
椭球体。 如果指定了 tilingScheme，则 此参数将被忽略，而使用切片方案的椭球体。如果两者都不是 参数，则使用 WGS84 椭球体。 | |
tileWidth |
number |
<optional> |
256 | 每个图块的宽度(以像素为单位)。 |
tileHeight |
number |
<optional> |
256 | 每个图块的高度(以像素为单位)。 |
minimumLevel |
number |
<optional> |
0 | 图像提供商支持的最低细节层次。 当 指定最低级别的瓦片数量较少，例如 4 或更少。 更大的数字是 可能会导致渲染问题。 |
maximumLevel |
number |
<optional> |
图像提供商支持的最大细节层次，如果没有限制，则为 undefined。 如果未指定，则没有限制。 | |
crs |
string |
<optional> |
CRS 规范，用于 WMS 规范 >= 1.3.0。 | |
srs |
string |
<optional> |
SRS 规范，用于 WMS 规范 1.1.0 或 1.1.1 | |
credit |
Credit | string |
<optional> |
数据源的积分，显示在画布上。 | |
subdomains |
string | Array.<string> |
<optional> |
'abc' | 用于 URL 模板中 {s} 占位符的子域。
如果此参数是单个字符串，则字符串中的每个字符都是一个子域。 如果是
一个数组，数组中的每个元素都是一个子域。 |
clock |
Clock |
<optional> |
确定时间维度值时使用的 Clock 实例。指定 'times' 时是必需的。 | |
times |
TimeIntervalCollection |
<optional> |
TimeIntervalCollection，其 data 属性是一个包含时间动态维度及其值的对象。 | |
getFeatureInfoUrl |
Resource | string |
<optional> |
WMS 服务的 getFeatureInfo URL。如果未定义属性，则我们使用 url 的属性值。 |