This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.



wm = webmap(___)



webmap opens a new web map in a browser, centering the map at the latitude, longitude point [0 0]. By default, webmap sets the base layer to World Street Map at the maximum spatial extent available. After the web map opens, you can select a different base layer using the Layer Manager available on the right side of the web map. Named base layers are tiled at discrete zoom resolutions.


The webmap function requires an internet connection. MathWorks cannot guarantee the stability and accuracy of web maps, as the servers are on the Internet and are independent from MathWorks. Occasionally, maps may be slow to display, display partially, or fail to display, because web map servers can become unavailable for short periods of time.


webmap(baseLayer) opens a new web map with baseLayer as the default base layer. See baseLayer for a list of the available maps.

webmap(wmsLayer) Opens a new web map with wmsLayer as the default base layer. wmsLayer is a WMSLayer array. The LayerTitle property of each wmsLayer is set as an item in the Layer Manager.

webmap displays WMS layers in the "Web Mercator" map coordinate reference system, if that projection is available for all layers in the array. Otherwise, webmap displays the layers in the EPSG:4326 geographic coordinate reference system. When using EPSG:4326, webmap does not include the default base layers in the Layer Manager since they are in a different coordinate reference system. These projections include a geographic quadrangle bounded north/south by parallels and east/west by meridians. Parallels map to horizontal lines. Meridians map to vertical lines.

webmap(customBasemap) opens a new web map using the custom basemap specified by the addCustomBasemap function. customBasemap is a string scalar or character vector specifying the display name of the custom basemap, if provided, or the basemap name.

webmap(___,Name,Value) opens a new web map with additional display properties specified as name-value pairs.

wm = webmap(___) returns a handle to a web map, wm.

webmap(wm) makes the web map specified by wm the current web map.


collapse all

Open a web map centered at [0 0].


To view the list of available base maps, click the expander arrow on the right side of the image.

Open a web map specifying the base layer and show the full extent of the world.

webmap('Light Gray Canvas Map', 'WrapAround', false)

Retrieve the Blue Marble WMS layer.

nasa = wmsfind('nasa', 'SearchField', 'serverurl');
baselayer = refine(nasa, 'bluemarbleng',  ...
                   'SearchField', 'layername',... 
                   'MatchType', 'exact');
baselayer = wmsupdate(baselayer);

Display a web map with the Blue Marble WMS layer as the base layer.


Add a custom base layer, specifying its name, URL, attribution, and display name.

name = 'opentopomap';
url = '';
attribution = '©OpenStreetMap contributors';
displayName = 'Open Topo Map';
addCustomBasemap(name,url,'Attribution',attribution, ...

Display a web map, specifying the custom base layer by the name you created when you added the basemap: opentopomap

webmap opentopomap

Input Arguments

collapse all

Map displayed in web map browser, specified as a string scalar or character vector, listed in the following table. If specified as string scalar or character vector, the value is case insensitive and spaces are optional.

'World Street Map'

Worldwide street map provided by Esri®. For information about the Esri ArcGIS Online layers, visit

'Open Street Map'

Street map from For more information, visit

'World Imagery'

Worldwide imagery provided by Esri.

'World Topographic Map'

Topographic map for the world from Esri.

'World Shaded Relief'Surface elevation as shaded relief provided by Esri
'World Physical Map'Natural Earth map of the world provided by Esri
'World Terrain Base'Shaded relief and bathymetry provided by Esri
'USGS Imagery'Composite of Blue Marble, NAIP, and Landsat provided by the USGS.
'USGS Topographic Imagery'Topographic map with imagery provided by the USGS.
'USGS Shaded Topographic Map'Composite of contours, shaded relief, and vector layers provided by the USGS.
'USGS Shaded Relief'Shaded relief from National Elevation Dataset provided by the USGS.
'National Geographic Map'General reference map provided by Esri
'DeLorme World Basemap'Topographic map provided by Esri
'Ocean Basemap'Bathymetry, marine features, depth in meter provided by Esri
'World Navigation Charts'Topographic data with nautical information provided by Esri
'Light Gray Canvas Map'Neutral background map with minimal colors provided by Esri

Data Types: char | string

Web map service layer, specified as a WMSLayer array.

Name of custom basemap, specified as a string scalar or character vector. The value is case-insensitive and spaces are optional.

Data Types: char | string

Web map, specified as a web map handle, returned by the webmap function.

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.

Example: webmap('Light Gray Canvas Map', 'WrapAround', false)

Map wrapping, specified as a logical value true (1) or false (0). If true, the map supports continuous pan and zoom across the 180-degree meridian. webmap constrains zoom to show less than 180 degrees of longitude at a time. If false, webmap clips the map to the west at -180 and to the east at +180. You can set the zoom to show the full extent of the world.

Data Types: double | logical

Output Arguments

collapse all

Web map, returned as a web map handle.

More About

collapse all

Web Map

An interactive map accessed through a web page. In a web map, you can select different map layers to view and navigate around the map using interactive tools, such as zooming. The web map browser is a window that displays map base layers obtained from web servers on the Internet. You can also display overlay layers that contain custom point and line vector data.


  • Particular maps may not support every available zoom level. If your map displays as white, try another zoom level. The map you are displaying might not support the zoom level you have currently selected. You can also select another base layer, which might support the specified zoom level.

Introduced in R2013b