wmcenter

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

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)

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.