Main Content

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.

Syntax

capabilities = WMSCapabilities(serverURL,capabilitiesResponse)

Description

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

example

Input Arguments

expand all

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

Data Types: char | string

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

Data Types: char | string

Properties

expand all

This property is read-only.

Title of WMS server, returned as a character vector.

Data Types: char

This property is read-only.

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

Data Types: char

This property is read-only.

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

Data Types: char

This property is read-only.

WMS version specification, returned as a character vector.

Data Types: char

This property is read-only.

Information about server, returned as a character vector.

Data Types: char

This property is read-only.

Online information about server, returned as a character vector.

Data Types: char

This property is read-only.

Contact information for an individual or an organization, returned 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

This property is read-only.

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

Data Types: char

This property is read-only.

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

Data Types: char

This property is read-only.

Descriptive keywords of the server, returned as a cell array of character vectors.

Data Types: char

This property is read-only.

Image formats supported by server, returned as a cell array of character vectors.

Data Types: char

This property is read-only.

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

Data Types: cell

This property is read-only.

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

This property is read-only.

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

Data Types: char

Object Functions

disp Display properties of WMS layers or capabilities

Examples

collapse all

Open Live Script

Create a WMSCapabilities object from the content 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);

Version History

Introduced in R2009b

See Also

| | |

Topics