WebMapServer class -

Web map server object

Description

A WebMapServer handle object represents a Web Map Service (WMS) and acts as a proxy to a WMS server. The WebMapServer handle object resides physically on the client side. The object can access the capabilities document on the WMS server and perform requests to obtain maps. It supports multiple WMS versions and negotiates with the server automatically to use the highest known version that the server can support.

To specify a proxy server to connect to the Internet, select File > Preferences > Web and enter your proxy information. Use this feature if you have a firewall.

Construction

server = WebMapServer(serverURL) constructs a WebMapServer object from the serverURL string parameter. The serverURL string parameter must include the protocol 'http://' or 'https://'. WebMapServer automatically communicates to the server defined by the serverURL using the highest known version that the server can support. serverURL can contain additional WMS keywords.

Properties

`Timeout`	Indicates the number of milliseconds before a server times out Data Type: `double` Default: 0 (Indicates that the time-out mechanism is ignored)
`EnableCache`	Indicates if caching is allowed. If `true`, the `WMSCapabilites` object is cached and returned when you use the `getCapabilities` method. The cache expires if the `AccessDate` property of the cached `WMSCapabilities` object is not the current day. Data Type: logical Default: `true`
`ServerURL`	Indicates the URL of the server Data Type: string
`RequestURL`	Indicates the URL of the last request to the server. `RequestURL` specifies a request for either the XML capabilities document or a map. You can insert the `RequestURL` into a browser. Data Type: string

Methods

getCapabilities	Get capabilities document from server
getMap	Get raster map from server
updateLayers	Update layer properties

Example

Construct a WebMapServer object that communicates with the Jet Propulsion Laboratory (JPL) WMS server and obtains its capabilities document.

jpl = wmsfind('jpl', 'SearchField', 'serverurl');
serverURL = jpl(1).ServerURL;
server = WebMapServer(serverURL);
capabilities = server.getCapabilities();