wmsupdate

Synchronize WMSLayer object with server

collapse all in page

Syntax

[updatedLayers,index] = wmsupdate(layers)
[...] = wmsupdate(layers,Name,Value, ...)

Description

[updatedLayers,index] = wmsupdate(layers) returns a Web Map Service (WMS) layer array with its properties synchronized with values from the server, where layers contains only one, unique ServerURL. wmsupdate removes layers that are no longer available on the server.

wmsupdate returns the logical array index which contains true for each available layer. Thus, the return value updatedLayers has the same size as layers(index). Except for deletion, updatedLayers preserves the same order of layers as layers.

[...] = wmsupdate(layers,Name,Value, ...) specifies parameter-value pairs that modify the request. Parameter names can be abbreviated and are case-insensitive.

The function accesses the Internet to update the properties. Periodically, the WMS server is unavailable. Updating the layer can take several minutes. The function times-out after 60 seconds if a connection is not made to the server.

Examples

collapse all

Open Live Script

Search the WMS database for layers from the NASA Goddard Space Flight Center. Then, synchronize the properties of the layers with values from the servers.

nasa = wmsfind('gsfc.nasa.gov','SearchField','serverurl');
nasa = wmsupdate(nasa,'AllowMultipleServers',true);
Open Live Script

Search the WMS database for layers from the NASA Goddard Space Flight Center SVS Image Server. Synchronize the properties of the layers with values from the server. Then, refine the search to find layers containing the term "blue marble".

gsfc = wmsfind('svs.gsfc.nasa.gov','SearchField','serverurl');
gsfc = wmsupdate(gsfc);
blue_marble = refine(gsfc,'blue marble','SearchField','abstract');

Further refine the search to find the first layer with a title containing the terms "512" and "image".

queryStr = '*512*image';
layers =  refine(blue_marble,queryStr);
layer = layers(1);

Display the layer.

[A,R] = wmsread(layer);
worldmap world
plabel off
mlabel off
geoshow(A,R)
title(layer.LayerTitle)

Input Arguments

collapse all

Updated layers, specified as an array of WMSLayer objects.

Data Types: char | string

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Number of seconds to elapse before a server times out, specified as an integer-valued, scalar double. If you specify the value 0, wmsinfo ignores the time-out mechanism.

Data Types: double | int16 | int32 | int64 | int8 | single | uint8 | uint16 | uint32 | uint64

Layer array may contain elements from multiple servers, specified as true or false. The value false indicates the array must contain elements from the same server. Use caution when setting the value to true, since you are making a request to each unique server and each request can take several minutes to finish.

Data Types: double | int16 | int32 | int64 | int8 | single | uint8 | uint16 | uint32 | uint64 | logical

Output Arguments

collapse all

Synchronized layers, returned as an array of WMSLayer objects with its properties synchronized with values from the server.

Available layers, returned as a logical array where the value true indicates that the layer was available from the server.

Tips

  • To specify a proxy server to connect to the Internet, click Preferences and, in the Preferences dialog box, select Web. Enter your proxy information. Use this feature if you have a firewall.

See Also

| | | |

Topics

Introduced in R2009b

Mapping Toolbox Documentation

Support