wmcenter

(To be removed) Set or obtain web map center point

collapse all in page

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

Syntax

wmcenter(centerLatitude,centerLongitude)

wmcenter(wm,centerLatitude,centerLongitude)

wmcenter(___,zoomLevel)

[lat,lon]
= wmcenter()

[lat,lon]
= wmcenter(wm)

Description

wmcenter(centerLatitude,centerLongitude) centers the current web map at the specified latitude and longitude. If there is no current web map, wmcenter creates a new web map.

wmcenter(wm,centerLatitude,centerLongitude) centers the web map, specified by the handle wm, at the specified latitude and longitude.

wmcenter(___,zoomLevel) centers and zooms the web map to the specified zoom level.

[lat,lon] = wmcenter() returns the latitude and longitude of the center point of the current web map.

[lat,lon] = wmcenter(wm) returns the latitude and longitude of the center point of the web map specified by the handle wm.

Examples

Specify and Query Center Point

Create a web map that uses the specified center point.

wmcenter(51,0)

Web map of the world, centered on Europe

Query the center point of the current web map.

[lat,lon] = wmcenter()

lat =

   51.0000


lon =

     0

Input Arguments

`centerLatitude` — Latitude of center point
scalar in the range `[-90 90]` of type `single` or `double`

Latitude of center point, specified as a scalar in the range [-90 90] of type single or double.

Data Types: single | double

`centerLongitude` — Longitude of center point
scalar in the range `[-180 180]` of type `single` or `double`

Longitude of center point, specified as a scalar in the range [-180 180] of type single or double.

Data Types: single | double

`wm` — Web map
web map handle

Web map, specified as a web map handle.¹

`zoomLevel` — Zoom level
scalar numeric integer in the range `[0 18]` of type `single` or `double`

Zoom level, specified as a scalar numeric integer in the range [0 18] of type single or double.

Data Types: single | double

Output Arguments

`lat` — Latitude of center point
scalar in the range `[-90 90]` of type `single` or `double`

Latitude of center point, returned as a scalar in the range [-90 90] of type single or double.

Data Types: single | double

`lon` — Longitude of center point
scalar in the range `[-180 180]` of type `single` or `double`

Longitude of center point, returned as a scalar in the range [-180 180] of type single or double.

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 wmcenter function. Use a geographic axes object and the MapCenter 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 wmcenter function and how to update your code to use the MapCenter property of a geographic axes object.

To Be Removed Recommended

Create a web map that uses the specified center point.

wmcenter(centerLatitude,centerLongitude)

Create a geographic axes object gx that uses the specified center point.

center = [centerLatitude centerLongitude];
gx = geoaxes(MapCenter=center);

Alternatively, store the current geographic axes object in gx. Then, change the coordinates of the center point.

gx = gca;
gx.MapCenter = [centerLatitude centerLongitude];

Create a web map that uses the specified center point and zoom level.

wmcenter(centerLatitude,centerLongitude,zoomLevel)

Create a geographic axes object gx that uses the specified center point and zoom level.

center = [centerLatitude centerLongitude];
gx = geoaxes(MapCenter=center,ZoomLevel=zoomLevel);

Alternatively, store the current geographic axes object in gx. Then, change the center point and zoom level.

gx = gca;
gx.MapCenter = [centerLatitude centerLongitude];
gx.ZoomLevel = zoomLevel;

Query the center point of the current web map.

[lat,lon] = wmcenter;

Store the current geographic axes object in gx. Then, query the center point.

gx = gca;
center = gx.MapCenter;
lat = center(1);
lon = center(2);

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

See Also

GeographicAxes Properties

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