Main Content




webmap opens a new web map, with its center 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(___,'WrapAround',tf), where tf is specified as the logical value false or 0, opens a new web map with the display clipped to the west at -180 degrees and to the east at +180 degrees. The default for tf is true or 1, which opens a map that supports continuous pan and zoom across the 180-degree meridian. The webmap function constrains zoom to show less than 180 degrees of longitude at a time.

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].


View the list of available base layers (basemaps) by clicking the expander arrow on the right side of the map.

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

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

Read the Blue Marble WMS layer.

info = wmsinfo('');
nasa = info.Layer;
baselayer = refine(nasa,'bluemarbleng',  ...
baselayer = wmsupdate(baselayer);

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


Add a custom base layer. To do this, specify 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. To do this, call webmap and specify the base layer using the name you gave it when you created it.

webmap opentopomap

Input Arguments

collapse all

Map displayed in the web map, 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

Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks.

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.

Output Arguments

collapse all

Web map, returned as a web map handle.


In MATLAB® Online™, if you refresh the URL, then the window containing the web map closes. In addition, if you returned a handle to the web map, then it is deleted.

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 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.

Compatibility Considerations

expand all

Behavior changed in R2021a

Behavior changed in R2020a

Introduced in R2013b