wmzoom

(To be removed) Set or obtain zoom level of web map

The wmzoom function will be removed in a future release. Use a geographic axes object and the ZoomLevel property of the object instead. For information on updating your code, see Version History.

Syntax

wmzoom(zoomLevel)

wmzoom(wm,zoomLevel)

zoomLevelOut = wmzoom()

zoomLevelOut = wmzoom(wm)

Description

wmzoom(zoomLevel) specifies the zoom level of the current web map, zoomLevel. If there is no current web map, wmzoom creates a new web map.

wmzoom(wm,zoomLevel) specifies the zoom level of the web map, specified by the handle wm.

zoomLevelOut = wmzoom() returns the zoom level of the current web map.

zoomLevelOut = wmzoom(wm) returns the zoom level of the web map specified by the handle wm.

Examples

Query and Specify Zoom Level

Display a marker on a web map.

wmmarker(51,0)

Query the zoom level of the current web map.

zoomLevelOut = wmzoom()

zoomLevelOut =

    15

Zoom out by specifying a new zoom level.

wmzoom(10)

Input Arguments

zoomLevel — Zoom level

scalar numeric integer in the range [0 18]

Zoom level, specified as a scalar numeric integer in the range [0 18].

Data Types: single | double

wm — Web map

web map handle

Web map, specified as a web map handle.¹

Output Arguments

zoomLevelOut — Zoom level of the current web map

scalar numeric integer in the range [0 18]

Zoom level of the current web map, returned as a scalar numeric integer in the range [0 18].

Data Types: single | double

Tips

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

Version History

Introduced in R2013b

R2025a: To be removed

Web maps will be removed in a future release, including the wmzoom function. Use a geographic axes object and the ZoomLevel property of the object instead.

Unlike web maps, geographic axes enable you to:

• Display data using additional plot types, including density plots and bubble charts.

• Customize your maps using MATLAB^® graphics functions.

• Build apps using App Designer.

This table shows some typical uses of the wmzoom function and how to update your code to use the ZoomLevel property of a geographic axes object.

To Be Removed	Recommended
Create a web map that uses the specified zoom level. wmzoom(zoomLevel)	Create a geographic axes object gx that uses the specified zoom level. gx = geoaxes(ZoomLevel=zoomLevel); Alternatively, store the current geographic axes object in a variable. Then, change the zoom level. gx = gca; gx.ZoomLevel = zoomLevel;
Query the zoom level of the current web map. zoomLevelOut = wmzoom;	Store the current geographic axes object in a variable. Then, query the zoom level. gx = gca; zoomLevelOut = gx.ZoomLevel;

For more information about migrating your web maps to geographic axes, see Web Map Migration Strategies.