WMSCapabilities

Web Map Service capabilities document

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.

Input Arguments

serverURL — URL of WMS server

character vector | string scalar

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

capabilitiesResponse — XML elements that describe the capabilities of the WMS server

character vector | string scalar

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

Data Types: char | string

Properties

ServerTitle — Title of WMS server

Read-only: character vector

This property is read-only.

Title of WMS server, returned as a character vector.

Data Types: char

ServerURL — URL of WMS server

Read-only: character vector

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

ServiceName — Name of Web map service

Read-only: character vector

This property is read-only.

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

Data Types: char

Version — WMS version specification

Read-only: character vector

This property is read-only.

WMS version specification, returned as a character vector.

Data Types: char

Abstract — Information about server

Read-only: character vector

This property is read-only.

Information about server, returned as a character vector.

Data Types: char

OnlineResource — Online information about server

Read-only: character vector

This property is read-only.

Online information about server, returned as a character vector.

Data Types: char

ContactInformation — Contact information for an individual or an organization

Read-only: structure

This property is read-only.

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

Field Name	Data Type	Field Content
Person	Character vector	Name of individual
Organization	Character vector	Name of organization
Email	Character vector	Email address

Data Types: struct

AccessConstraints — Constraints inherent in accessing the server

Read-only: character vector

This property is read-only.

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

Data Types: char

Fees — Types of fees associated with accessing server

Read-only: character vector

This property is read-only.

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

Data Types: char

KeywordList — Descriptive keywords of the server

Read-only: cell array of character vectors

This property is read-only.

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

Data Types: char

ImageFormats — Image formats supported by server

Read-only: cell array of character vectors

This property is read-only.

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

Data Types: char

LayerNames — Layer names provided by server

Read-only: cell array of character vectors

This property is read-only.

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

Data Types: cell

Layer — Information about layers on WMS server

Read-only: WMSLayer array

This property is read-only.

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

AccessDate — Date of request to server

Read-only: character vector

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

Create WMS Capabilities Object

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