提供由 Web 地图服务 (WMS) 服务器托管的瓦片影像。
| Name | Type | Description |
|---|---|---|
options |
WebMapServiceImageryProvider.ConstructorOptions | 描述初始化选项的对象 |
Example:
// 美国政府运营的 WMS 服务器 https://apps.nationalmap.gov/services/
const provider = new Cesium.WebMapServiceImageryProvider({
url : 'https://basemap.nationalmap.gov:443/arcgis/services/USGSHydroCached/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
获取或设置一个时钟，用于获取时间动态参数使用的时间。
readonly credit : Credit
获取当此影像提供程序处于活动状态时要显示的版权信息。通常用于注明
影像的来源。
获取或设置一个值，指示是否启用要素拾取。如果为 true，
WebMapServiceImageryProvider#pickFeatures 将
调用 WMS 服务器上的 GetFeatureInfo 服务并尝试解释响应中包含的要素。如果为 false，
WebMapServiceImageryProvider#pickFeatures 将立即返回 undefined（表示没有可拾取的
要素），而不与服务器通信。如果您知道数据源
不支持拾取要素，或者您不希望此提供程序的要素可被拾取，请将此属性设置为 false。
-
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
获取瓦片丢弃策略。如果未定义，则丢弃策略负责
通过其 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:
拾取要素的承诺，当异步
拾取完成时解析。解析值是一个
ImageryLayerFeatureInfo
实例数组。如果在给定位置未找到要素，数组可能为空。
requestImage(x, y, level, request) → Promise.<ImageryTypes>|undefined
请求给定瓦片的图像。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片 X 坐标。 |
y |
number | 瓦片 Y 坐标。 |
level |
number | 瓦片级别。 |
request |
Request | optional 请求对象。仅供内部使用。 |
Returns:
图像的承诺，当图像可用时解析，或者
如果服务器有太多活动请求而返回 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 服务器的附加参数。 |
enablePickFeatures |
boolean |
<optional> |
true | 如果为 true，WebMapServiceImageryProvider#pickFeatures 将调用
WMS 服务器上的 GetFeatureInfo 操作并返回响应中包含的要素。如果为 false，
WebMapServiceImageryProvider#pickFeatures 将立即返回 undefined（表示没有可拾取的要素），
而不与服务器通信。如果您知道 WMS 服务器不支持
GetFeatureInfo，或者您不希望此提供程序的要素可被拾取，请将此属性设置为 false。请注意，这可以通过修改 WebMapServiceImageryProvider#enablePickFeatures 属性动态
覆盖。 |
getFeatureInfoParameters |
object |
<optional> |
WebMapServiceImageryProvider.GetFeatureInfoDefaultParameters | 在 GetFeatureInfo URL 中传递给 WMS 服务器的附加参数。 |
getFeatureInfoUrl |
Resource | string |
<optional> |
WMS 服务的 getFeatureInfo URL。如果未定义此属性，则使用 url 属性的值。 | |
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 | 影像提供程序支持的最小细节级别。指定时请注意 最小级别的瓦片数量要少，例如四个或更少。数量较大 可能导致渲染问题。 |
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 属性是一个包含时间动态维度及其值的对象。 |