Skip To Content ArcGIS for Developers Sign In Dashboard

WmsLayer QML Type

Defines an Open Geospatial Consortium (OGC) Web Map Tile Service (WMS) layer. More...

Import Statement: import Esri.ArcGISRuntime 100.6
Since: Esri.ArcGISRuntime 100.2
Inherits:

ImageAdjustmentLayer

Properties

Signals

Detailed Description

An instance of this class allows you to display data from a WMS service.

WmsLayer adopts the loadable pattern; many of its properties are initialized asynchronously. The layer is loaded when displayed in a MapView or a SceneView. If using the layer without a MapView or a SceneView, call the load method before use. Use the layer loadStatus property to determine when the layer is ready, and check the loadStatus before using the layer.

Required propertiesurllayerNameslayerInfos
url and layerNamesrequiredrequiredunused
layerInfosunusedunusedrequired

Default properties

This QML type supports the following default properties. A default property may be declared inside another declared object without being assigned explicitly to a property.

See also LayerContent, Loadable, RemoteResource, TimeAware, WmsServiceInfo, WmsLayerInfo, and Loadable.

Property Documentation

[default] credential : Credential

The credential used to access a secured WMS service.

The credential cannot be changed after the layer is loaded.


customParameters : jsobject

Returns key/value pairs representing the custom parameters that are applied to the WMS requests related to this layer.

The key and value for each key/value pair must be strings, where the key is the parameter's name and the value the parameter's value.

When making a WMS request, only parameters required by the service are included by default. Setting custom parameters will allow you to specify any additional parameters, such as API keys or user credentials, to the service. These parameters will be appended to GetMap and GetFeatureInfo requests.

When used together with a WmsService, if a parameter with the same name is defined in the service's custom parameters, then layer-specific values will take precedence over service-wide parameter values.

This QML property was introduced in Esri.ArcGISRuntime 100.3.


fullTimeExtent : TimeExtent

Returns the full time extent of the time aware layer (read-only).

Note: This property is only available after the time aware layer is loaded.

This QML property was introduced in Esri.ArcGISRuntime 100.3.

See also TimeExtent.


[default] item : ArcGISItem

The item used to initialize this WMSLayer.

The item cannot be changed after the layer is loaded.


layerInfos : list<WmsLayerInfo>

A list of WmsLayerInfo objects describing the selected WMS sublayers.


layerNames : list<string>

A list of names of visible WMS layers.


preferredImageFormat : Enums.MapServiceImageFormat

Returns the preferred image format of this WMS layer (read-only).

If a preferred format is not specified prior to loading, then Enums.MapServiceImageFormat.Png32 is used.

See also Enums.MapServiceImageFormat.


refreshInterval : int

The refresh interval used by the layer in milliseconds.

Layers request data from the service each time this interval elapses.

A value of 0 means to never refresh.

Note: The value is treated as unsigned and cannot be negative.


requestConfiguration : RequestConfiguration

Returns the RequestConfiguration in use by this layer.


sublayers : list<WmsSublayer>

Returns a list of WmsSublayer for this WMS Layer


supportsTimeFiltering : bool

Returns whether the time aware layer supports filtering its contents by time values (read-only).

This QML property was introduced in Esri.ArcGISRuntime 100.3.


timeFilteringEnabled : bool

Returns whether the time aware layer participates in filtering based on the time extent of its geo view.

This QML property was introduced in Esri.ArcGISRuntime 100.3.


timeInterval : TimeValue

Returns a time interval that represents the suggested step size for use when manipulating the time extent (read-only).

This information can be used to set the step size for a time slider control.

Note: This property is only available after the time aware layer is loaded.

This QML property was introduced in Esri.ArcGISRuntime 100.3.

See also TimeValue.


timeOffset : TimeValue

The time offset of the time aware layer.

The time offset is subtracted from the time extent set on the time aware layer's geo view. This can be used to overlay data from different periods of time for comparison.

Note: This property is only available after the layer is loaded.

This QML property was introduced in Esri.ArcGISRuntime 100.3.

See also TimeValue.


url : url

The URL of the WMS service.

/sa /l WmsService::url.


version : Enums.WmsVersion

The version of this WMS Layer.

ArcGIS Runtime supports WMS versions 1.3.0, 1.1.1, and 1.1.0. The latest supported WMS version is set as the default.

See also Enums.WmsVersion.


Signal Documentation

credentialChanged()

Emitted when the credential property changes.


customParametersChanged()

Emitted when the customParameters property changes.

This QML signal was introduced in Esri.ArcGISRuntime 100.3.


fullTimeExtentChanged()

Emitted when the fullTimeExtent property of the time aware layer changes.

This QML signal was introduced in Esri.ArcGISRuntime 100.3.


layerInfosChanged()

Emitted when the layerInfos property changes.


layerNamesChanged()

Emitted when the layerNames property changes.


preferredImageFormatChanged()

Emitted when the preferredImageFormat property changes.


refreshIntervalChanged()

Emitted when the refreshInterval property changes.


requestConfigurationChanged()

Emitted when the requestConfiguration property changes.


sublayersChanged()

Emitted when the sublayers property changes.


supportsTimeFilteringChanged()

Emitted when the supportsTimeFiltering property of the time aware layer changes.

This QML signal was introduced in Esri.ArcGISRuntime 100.3.


timeFilteringEnabledChanged()

Emitted when the timeFilteringEnabled property of the time aware layer changes.

This QML signal was introduced in Esri.ArcGISRuntime 100.3.


timeIntervalChanged()

Emitted when the timeInterval property of the time aware layer changes.

This QML signal was introduced in Esri.ArcGISRuntime 100.3.


timeOffsetChanged()

Emitted when the timeOffset property of the time aware layer changes.

This QML signal was introduced in Esri.ArcGISRuntime 100.3.


urlChanged()

Emitted when the url property changes.


versionChanged()

Emitted when the version property changes.



Feedback on this topic?