WebMapServiceImageryProvider

new SuperMap3D.WebMapServiceImageryProvider(options)

提供由网络地图服务（WMS）服务器托管的切图影像。
Name Type Description
options Object 具有以下属性的对象:
Name Type Default Description
url String WMS 服务的 URL。该 URL 支持与 UrlTemplateImageryProvider 相同的关键字。
layers String 要包含的图层，用逗号分隔。
parameters Object WebMapServiceImageryProvider.DefaultParameters optional 在 GetMap URL 中传递给 WMS 服务器的附加参数。
getFeatureInfoParameters Object WebMapServiceImageryProvider.GetFeatureInfoDefaultParameters optional 在 GetFeatureInfo URL 中传递给 WMS 服务器的附加参数。
enablePickFeatures Boolean true optional 如果为true，WebMapServiceImageryProvider#pickFeatures将在WMS服务器上调用GetFeatureInfo操作并返回响应中包含的特征。 如果为false，WebMapServiceImageryProvider#pickFeatures将在不与服务器通信的情况下立即返回undefined(表示没有可选择的功能)。 如果您知道您的WMS服务器不支持GetFeatureInfo，或者您不希望此提供商的特性是可选择的，请将此属性设置为false。 注意，这可以通过修改WebMapServiceImageryProvider#enablePickFeatures属性来动态覆盖。
getFeatureInfoFormats Array.<GetFeatureInfoFormat> WebMapServiceImageryProvider.DefaultGetFeatureInfoFormats optional 尝试WMS GetFeatureInfo请求的格式。
rectangle Rectangle Rectangle.MAX_VALUE optional 图层的矩形。
tilingScheme TilingScheme new GeographicTilingScheme() optional 将地理划分为若干块的切图方案。
ellipsoid Ellipsoid optional 椭球。如果指定了切图方案，则忽略此参数，而使用切图方案的椭球。如果不指定任何参数，则使用WGS84椭球。
tileWidth Number 256 optional 每个瓦片的宽度（像素）。
tileHeight Number 256 optional 每个瓦片的高度（像素）。
minimumLevel Number 0 optional 影像提供者支持的最小精细级别。指定时要注意，最小级别的瓦片数量要少，如四个或更少。如果数量较多，可能会导致渲染问题。
maximumLevel Number optional 影像提供者支持的最大精细级别；如果没有限制，则未定义。如果未指定，则没有限制。
credit Credit | String optional 数据源的凭证，显示在画布上。
proxy Object optional 用于请求的代理。如果需要，该对象应具有一个 getURL 函数，用于返回代理 URL。
subdomains String | Array.<String> 'abc' optional 用于 URL 模板中 {s} 占位符的子域。如果该参数是单字符串，则字符串中的每个字符都是一个子域。如果是数组，数组中的每个元素都是一个子域。
Example:
var provider = new SuperMap3D.WebMapServiceImageryProvider({
    url : 'https://sampleserver1.arcgisonline.com/ArcGIS/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/WMSServer',
    layers : '0',
    proxy: new SuperMap3D.DefaultProxy('/proxy/')
});

viewer.imageryLayers.addImageryProvider(provider);
See:

Members

staticconstantSuperMap3D.WebMapServiceImageryProvider.DefaultParameters

在 WMS URL 中包含的用于获取影像的默认参数。参数值如下： service=WMS version=1.1.1 request=GetMap styles= format=image/jpeg

staticconstantSuperMap3D.WebMapServiceImageryProvider.GetFeatureInfoDefaultParameters

在 WMS URL 中包含的用于获取特征信息的默认参数。参数值如下： service=WMS version=1.1.1 request=GetFeatureInfo

readonlycredit : Credit

获取该影像提供者激活时要显示的凭证。通常情况下，这将用于标明影像来源。此函数不应在 WebMapServiceImageryProvider#ready 返回 true 之前调用。

enablePickFeatures : Boolean

获取或设置表示是否启用特征选择的值。如果为true，WebMapServiceImageryProvider#pickFeatures将调用WMS服务器上的GetFeatureInfo服务，并尝试解释响应中包含的地物信息。 如果设置为 false，WebMapServiceImageryProvider#pickFeatures将立即返回未定义（表示没有可选取的特征），而不会与服务器进行通信。 如果您知道您的数据源不支持选取特征，或者您不希望该提供程序的特征是可选取的，请将此属性设为 false。
Default Value: true

readonlyerrorEvent : Event

获取在影像提供程序遇到异步错误时引发的事件。通过订阅该事件，您将收到错误通知，并有可能从中恢复。事件侦听器会收到一个 TileProviderError 的实例。

readonlyhasAlphaChannel : Boolean

获取指示该影像提供程序提供的影像是否包含 alpha 通道的值。 如果该属性为 false，则会忽略存在的 alpha 通道。 如果该属性为 true，任何不包含 alpha 通道的影像都将被视为其 alpha 值为 1.0 的影像。 此属性为false时，内存使用量和纹理上传时间都会减少。

readonlylayers : String

获取 WMS 图层的名称，以逗号分隔。

readonlymaximumLevel : Number

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

readonlyminimumLevel : Number

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

readonlyproxy : Proxy

获取该提供程序使用的代理。

readonlyready : Boolean

获取表示提供程序是否可以使用的值。

readonlyreadyPromise : Promise.<Boolean>

获取当提供程序准备就绪时解析为 true 的Promise。

readonlyrectangle : Rectangle

获取此实例所提供影像的矩形（以弧度为单位）。此函数不应在 WebMapServiceImageryProvider#ready 返回 true 之前调用。

readonlytileDiscardPolicy : TileDiscardPolicy

获取瓦片丢弃策略。如果未定义，则丢弃策略负责通过其 shouldDiscardImage 函数过滤 "丢失 "的瓦片。 如果此函数返回未定义，则不会过滤任何瓦片。在 WebMapServiceImageryProvider#ready 返回 true 之前，不应调用此函数。

readonlytileHeight : Number

获取每个瓦片的高度（以像素为单位）。此函数不应在 WebMapServiceImageryProvider#ready 返回 true 之前调用。

readonlytileWidth : Number

获取每个瓦片的宽度（以像素为单位）。此函数不应在 WebMapServiceImageryProvider#ready 返回 true 之前调用。

readonlytilingScheme : TilingScheme

获取此提供程序使用的切图方案。此函数不应在 WebMapServiceImageryProvider#ready 返回 true 之前调用。

readonlyurl : String

获取 WMS 服务器的 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

异步确定瓦片中给定经度和纬度处的地物（如果有的话）。该函数不应在 ImageryProvider#ready 返回 true 之前调用。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的级别。
longitude Number 选取特征的经度。
latitude Number 选取特征的纬度。
Returns:
当异步提取完成时，将解析所提取特征的Promise。 解析值是一个由 ImageryLayerFeatureInfo 实例组成的数组。 如果在给定位置未找到任何特征，数组可能为空。
Throws:
  • DeveloperError : pickFeatures 不得在影像提供程序准备就绪前调用。

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

请求指定瓦片的影像。此函数不应在 WebMapServiceImageryProvider#ready 返回 true 之前调用。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的级别。
request Request optional 请求对象。仅供内部使用。
Returns:
影像的Promise，该Promise将在影像可用时解析该影像；如果服务器上有太多活动请求，则未定义该Promise，请求应稍后重试。解析的影像可以是影像或 Canvas DOM 对象。
Throws:
  • DeveloperError : requestImage 不得在影像提供程序准备就绪前调用。