WMSCapabilities

Web Map Service capabilities document

expand all in page

Description

A WMSCapabilities object represents a Web Map Service (WMS) capabilities document obtained from a WMS server. A capabilities document is an XML document that contains metadata describing the geographic content offered by the server.

Creation

You can create a WMSCapabilities object using the WMSCapabilities function described here, or using the wmsinfo function to specify a timeout. A WMSCapabilities is also returned from the getCapabilities function when you have a WebMapServer object.

capabilities = WMSCapabilities(serverURL,capabilitiesResponse)

Description

example

capabilities = WMSCapabilities(serverURL,capabilitiesResponse) creates a WMSCapabilities object, setting the ServerURL property and defining the capabilities of the server using the XML elements in capabilitiesResponse.

Input Arguments

expand all

XML elements that describe the capabilities of the WMS server, specified as a character vector.

Example: 'uint8=>char'

Data Types: char

Properties

expand all

Title of WMS server, specified as a character vector.

Data Types: char

URL of WMS server, specified as a character vector. The server URL must include the protocol 'http://' or 'https://'.

Data Types: char

Name of Web map service, specified as a character vector.

Data Types: char

WMS version specification, specified as a character vector.

Data Types: char

Information about server, specified as a character vector.

Data Types: char

Online information about server, specified as a character vector.

Data Types: char

Contact information for an individual or an organization, specified as a ContactInformation structure, containing the following fields:

Field NameData TypeField Content
PersonCharacter vectorName of individual
OrganizationCharacter vectorName of organization
EmailCharacter vectorEmail address

Data Types: struct

Constraints inherent in accessing the server, such as server load limits, specified as a character vector.

Data Types: char

Types of fees associated with accessing server, specified as a character vector.

Data Types: char

Descriptive keywords of the server, specified as a character vector.

Data Types: char

Image formats supported by server, specified as a character vector.

Data Types: char

Layer names provided by server, specified as a cell array of character vectors.

Data Types: cell

Information about layers on WMS server, specified as an array of WMSLayer objects.

Date of request to server, specified as a character vector.

Data Types: char

Object Functions

disp Display properties of WMS layers or capabilities

Examples

collapse all

Create a WMSCapabilities object from the contents of a downloaded capabilities file from the NASA SVS Image Server.

nasa = wmsfind('NASA SVS Image', 'SearchField', 'servertitle');
serverURL = nasa(1).ServerURL;
server = WebMapServer(serverURL);
capabilities = server.getCapabilities;
filename = 'capabilities.xml';
websave(filename, server.RequestURL);
    
fid = fopen(filename, 'r');
capabilitiesResponse = fread(fid, 'uint8=>char');
fclose(fid);
capabilities = WMSCapabilities(serverURL, capabilitiesResponse);

See Also

| | |

Topics

Introduced in R2009b

Mapping Toolbox Documentation

Support