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. Please click here
To view all translated materials including this page, select Japan 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 located 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 base layer specified by baseLayer. baseLayer can be one of a list of named Web Map Service providers or a WMSLayer array. If baseLayer is a matrix of WMSLayer objects, webmap uses each object’s LayerTitle property as the value of items in the Layer Manager.

webmap displays named base layers in the Web Mercator map coordinate reference system. webmap displays WMSLayers in the Web Mercator map coordinate reference system, if that projection (EPSG:900913) is available for all layers in the array. Otherwise, webmap displays WMSLayers in the EPSG:4326 geographic coordinate reference system. When displaying a WMSLayer in the EPSG:4326 geographic coordinate reference system, webmap does not include the named base layers in the Layer Manager, because they are in a different coordinate reference system. These projections include a geographic quadrangle bounded north and south by parallels (which map to horizontal lines) and east and west by meridians (which map to vertical lines).

webmap(___,Name,Value) opens a new web map with additional display properties set.

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)

Open a web map and 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.


Input Arguments

collapse all

Map displayed in web map browser, specified as a character vector, listed in the following table, or a WMSLayer array. If specified as 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

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 single 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)

collapse all

Control 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, but zoom is constrained to show less than 180 degrees of longitude at a time. If false, the map is clipped to the west at -180 and clipped to the east at +180, and zoom can be set 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, a user 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 located 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 completely white, try another zoom level. The map you are displaying may 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

Was this topic helpful?