getMap

Get raster map from server

Syntax

A = getMap(server,mapRequestURL)

Description

A = getMap(server,mapRequestURL) dynamically renders and retrieves a color or grayscale, geographically referenced, raster map from the Web map services server, server, and stores it in A. Parameters in the URL, mapRequestURL, define the map. The getMap function also updates the RequestURL property of the server with mapRequestURL.

Examples

Retrieve Map from NASA Earth Observations WMS Server

Retrieve a map of the Blue Marble global mosaic layer from the NASA Earth Observations WMS server.

neowms = wmsfind('neowms', 'SearchField', 'serverurl');
layer = refine(neowms, 'bluemarbleng', 'MatchType', 'exact');

server = WebMapServer(layer.ServerURL);
mapRequest = WMSMapRequest(layer, server);
A = getMap(server, mapRequest.RequestURL);
R = mapRequest.RasterReference;

Display the map.

figure
worldmap world
geoshow(A, R)
setm(gca,'MLabelParallel',-90,'MLabelLocation',90)
title(layer.LayerTitle)

Input Arguments

server — Web map server

WebMapServer object

Web map server, specified as a WebMapServer object.

mapRequestURL — URL

character vector

URL, specified as a character vector. Parameters in the URL define the map.

Output Arguments

A — Rendered map

color or grayscale image

Rendered map, returned as a color or grayscale image.

Tips

getMap accesses the Internet to retrieve the map. Periodically, the WMS server is unavailable. Retrieving the map can take several minutes.