wmlimits

(To be removed) Set or obtain web map limits

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

Syntax

wmlimits(latitudeLimits,longitudeLimits)

wmlimits(wm,latitudeLimits,longitudeLimits)

[latlim,lonlim] = wmlimits()

[latlim,lonlim] = wmlimits(wm)

Description

wmlimits(latitudeLimits,longitudeLimits) center the current web map within the specified latitude limits and the longitude limits. If there is no current web map, wmlimits creates one.

Note

The resulting limits often do not match the specified limits because the zoom level is quantized to discrete integer values and the longitude limits may be constrained if the map was constructed with the WrapAround property equal to false.

wmlimits(wm,latitudeLimits,longitudeLimits) centers the web map specified by the web map handle wm within the specified latitude limits and longitude limits.

[latlim,lonlim] = wmlimits() returns the latitude and longitude limits of the current web map.

[latlim,lonlim] = wmlimits(wm) returns the latitude and longitude limits of the web map specified by wm.

Examples

Specify and Query Limits

Create a web map that uses the specified latitude and longitude limits.

wmlimits([37 42],[-108.9 -100.7])

Get the latitude and longitude limits of the current web map.

[latitudeLimits,longitudeLimits] = wmlimits()

latitudeLimits =

   34.7311   44.0468


longitudeLimits =

 -113.0397  -96.5603

Input Arguments

latitudeLimits — Latitude limits in degrees

1-by-2 row vector of type double

Latitude limits in degrees, specified as a 1-by-2 row vector of type double of the form [southern-limit northern-limit].

Example: [37, 42]

Data Types: double

longitudeLimits — Longitude limits in degrees

1-by-2 row vector of type double

Longitude limits in degrees, specified as a 1-by-2 row vector of type double of the form [western-limit eastern-limit].

Example: [-108.9, -100.7]

Data Types: double

wm — Web map

scalar web map handle

Web map, specified as a scalar web map handle.¹

Output Arguments

latlim — Latitude limits in degrees

1-by-2 row vector of type double

Latitude limits in degrees, returned as a 1-by-2 row vector of type double.

Example: [37, 42]

Data Types: double

lonlim — Longitude limits in degrees

1-by-2 row vector of type double

Longitude limits in degrees, returned as a 1-by-2 row vector of type double.

Example: [-108.9, -100.7]

Data Types: double

Version History

Introduced in R2013b

R2025a: To be removed

Web maps will be removed in a future release, including the wmlimits function. Use a geographic axes object and the geolimits function 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 wmlimits function and how to update your code to use a geographic axes object and the geolimits function.

To Be Removed	Recommended
Change the latitude and longitude limits of the current web map. wmlimits(latitudeLimits,longitudeLimits)	Change the latitude and longitude limits of the current geographic axes object. geolimits(latitudeLimits,longitudeLimits)
Change the latitude and longitude limits of the web map wm. wmlimits(wm,latitudeLimits,longitudeLimits)	Change the latitude and longitude limits of the geographic axes object gx. geolimits(gx,latitudeLimits,longitudeLimits)
Query the latitude and longitude limits of the current web map. [latlim,lonlim] = wmlimits;	Query the latitude and longitude limits of the current geographic axes object. [latlim,lonlim] = geolimits;

Similar to the wmlimits function, the geolimits function typically uses wider limits than the limits you specify, to maintain the aspect ratio of the map.

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