wmmarker

(To be removed) Display geographic marker on web map

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

Syntax

wmmarker(lat,lon)

wmmarker(P)

wmmarker(wm,___)

wmmarker(__,Name,Value)

h = wmmarker(___)

Description

wmmarker(lat,lon) displays a marker overlay at the points specified by lat and lon on the current web map. If there is no current web map, wmmarker creates one. wmmarker centers the map so that all vector overlays on the web map are visible. A marker is also called a map pin.

wmmarker(P) displays a marker overlay based on the vector geographic features stored in P. Each element of P defines one marker overlay.

wmmarker(wm,___) displays the overlay in the web map specified by the web map handle, wm.

wmmarker(__,Name,Value) specifies name-value pairs that set additional display properties. Parameter names can be abbreviated and are case-insensitive.

h = wmmarker(___) returns a handle to the overlay.

Examples

Display Marker on Web Map

Display a marker on a web map.

wmmarker(51.519,-0.13)

The function adds the marker name to the list of overlays in the Layer Manager. The default name is Marker Overlay 1.

Input Arguments

lat — Latitudes of points

matrix

Latitudes of points, specified as a matrix.

Data Types: single | double

lon — Longitudes of points

matrix

Longitudes of points, specified as a matrix.

Data Types: single | double

P — Geographic features

geospatial table | geopoint vector

Geographic features, specified as one of the following:

• A geospatial table containing geopointshape objects. For more information about geospatial tables, see Create Geospatial Tables.

• A geopoint vector.

wm — Web map

web map handle

Web map, specified as a web map handle.¹

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: wmmarker(lat,lon,'Autofit',true)

Autofit — Overlay visibility

true (default) | false

Overlay visibility, specified as the comma-separated pair consisting of 'Autofit' and the logical flag true or false, or the numeric value 1 or 0. If true or 1, wmmarker adjusts the spatial extent of the map to ensure that all the vector overlays on the map are visible. If false, wmmarker does not adjust the spatial extent when the overlay is added to the map.

Overlay visibility, specified as a scalar logical or numeric value true (1) or false (0).

• If true, wmmarker adjusts the spatial extent of the map to ensure that all the vector overlays on the map are visible.

• If false, wmmarker does not adjust the spatial extent when the overlay is added to the map.

Data Types: double | logical

Description — Description of feature

empty character vector (' ') (default) | character vector | cell array of character vectors | scalar structure

Description of feature, specified as the comma-separated pair consisting of 'Description' and a character vector, cell array of character vectors, or scalar structure. The description defines the content that wmmarker displays in the feature’s description balloon which appears when a user clicks on the feature in the web map. Description elements can be either plain text or HTML markup. When you specify an attribute spec, the display in the balloon for the attribute fields of P are modified according to the specification. The default value is an empty character vector (''). If the value is a structure, the attribute spec is applied to the attributes of each feature of P and ignored with lat and lon input.

• If the value is a cell array it is either scalar or the same length as P, or lat and lon, and specifies the description for each marker.

• If the value is a structure, the attribute spec is applied to the attributes of each feature of P and ignored with lat and lon input.

Data Types: char | struct | cell

OverlayName — Name of overlay layer

'Marker Overlay N', (default) | character vector

Name of overlay layer, specified as the comma-separated pair consisting of 'OverlayName' and a character vector. wmmarker inserts the name in the Layer Manager under the Overlays item. The Layer Manager is the tool that appears on the right side of the web map frame. The default name is 'Marker Overlay N' where N is the number assigned to this overlay.

Data Types: char

FeatureName — Name of feature

'OverlayName: Point K' (default) | character vector | cell array of character vectors

Name of feature, specified as the comma-separated pair consisting of 'FeatureName' and a character vector or cell array of character vectors. The name appears in the feature's balloon when a user clicks on the feature in the web map. The default value is 'OverlayName : Point K', where OverlayName is the name of the overlay and K is the number assigned to a particular point. If the value is a character vector, wmmarker applies it to all features. If the value is a cell array, it must be a scalar or an array with the same length as P or lat and lon.

Data Types: char | cell

Icon — File name of custom icon for a marker

character vector | cell array of character vectors

File name of custom icon for a marker, specified as the comma-separated pair consisting of 'Icon' and a character vector or cell array of character vectors. If the icon file name is not in the current folder, or in a folder on the MATLAB^® path, specify a full or relative path name. If you specify an Internet URL it must include the protocol type. If the icon file name is not specified, the default icon is displayed. For best results when you want to view a non-default icon, specify a PNG file containing image data with an alpha mask.

• If the value is a character vector, wmmarker applies the value to all markers.

• If you specify a cell array, it must be the same length as P, or lat and lon, and specifies the icon for each marker.

Data Types: char | cell

IconScale — Scaling factor for icon

1 (default) | positive numeric scalar or vector.

Scaling factor for icon, specified as the comma-separated pair consisting of 'IconScale' and a positive numeric scalar or vector.

• If the value is a scalar, the value is applied to all icons.

• If the value is a vector, it must specify a value for each icon, and it must be the same length as lat and lon or P.

Data Types: double

Color — Icon color

'red' (default) | color name | RGB triplet | cell array of color names | string vector of color names | matrix of RGB triplets

Icon color, specified as the comma-separated pair consisting of 'Color' and one of these options.

• A color name such as 'red' or a short name such as 'r'.

• An RGB triplet, which is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1]; for example, [0.4 0.6 0.7].

• A cell array of color names such as {'red','green','blue'} or {'r','g','b'}.

• A string vector of color names such as ["red" "green" "blue"] or ["r" "g" "b"].

• A matrix of RGB triplets, which is a three-column matrix in which each row is an RGB triplet.

The way you specify the color depends on the desired color scheme.

• To apply the same color to all icons, specify a single color name or RGB triplet.

• To apply a different color to each icon, specify a cell array of color names, a string vector of color names, or a matrix of RGB triplets. The number of colors and RGB triplets must match the length of lat and lon or P.

If you specify a custom icon file, then the wmmarker function ignores this argument.

This table contains the color names and equivalent RGB triplets for some common colors.

Color Name	Short Name	RGB Triplet	Appearance
"red"	"r"	[1 0 0]
"green"	"g"	[0 1 0]
"blue"	"b"	[0 0 1]
"cyan"	"c"	[0 1 1]
"magenta"	"m"	[1 0 1]
"yellow"	"y"	[1 1 0]
"black"	"k"	[0 0 0]
"white"	"w"	[1 1 1]

Data Types: char | string | cell | double

Alpha — Transparency of marker

1 (default) | numeric scalar or vector

Transparency of marker, specified as the comma-separated pair consisting of 'Alpha' and a numeric scalar or vector. If you specify a vector, it must include a value for each marker, that is, the vector must be the same length as P. The default value, 1, means that the marker is fully opaque.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Output Arguments

h — Marker overlay

handle to a marker overlay object

Marker overlay, returned as a handle to a marker overlay object.

Version History

Introduced in R2013b

R2025a: To be removed

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

To Be Removed	Recommended
Display markers at the specified latitude and longitude coordinates. wmmarker(lat,lon)	Display icons at the specified latitude and longitude coordinates. geoiconchart(lat,lon)
Display markers using the point shapes stored in the geospatial table GT. wmmarker(GT)	Extract the latitude and longitude coordinates from the geospatial table. Use the coordinates as input to geoiconchart. lat = GT.Shape.Latitude; lon = GT.Shape.Longitude; geoiconchart(lat,lon)
Display markers using the coordinates stored in the geopoint vector P. wmmarker(P)	Extract the latitude and longitude coordinates from the geopoint vector. Use the coordinates as input to geoiconchart. lat = P.Latitude; lon = P.Longitude; geoiconchart(lat,lon)
Specify an icon file using the Icon name-value argument. wmmarker(lat,lon,Icon=filename)	Specify the icon file using a string scalar or a character vector. The function uses the same file for all the icons. geoiconchart(lat,lon,filename)
Specify a scale factor for the icon by using the IconScale name-value argument. wmmarker(lat,lon,IconScale=scale)	Convert the scale factor to a size in point units. Then, specify the size of the icon by using the SizeData name-value argument. sz = scale*32; geoiconchart(lat,lon,SizeData=sz)
Specify the icon color by using the Color name-value argument. wmmarker(lat,lon,Color=colorValue)	Specify the icon color by using the IconColorData name-value argument. For an example that shows how to control the icon color, see Control Color and Transparency of Icon Chart.
Specify the icon transparency by using the Alpha name-value argument. wmmarker(lat,lon,Alpha=alphaValue)	Specify the icon transparency by using the IconAlphaData name-value argument. For an example that shows how to control the icon transparency, see Control Color and Transparency of Icon Chart.
Exclude the icon data from the automatic selection of the map limits by using the AutoFit name-value argument. wmmarker(lat,lon,AutoFit=false)	Exclude the icon anchor points from the automatic selection of the map limits by using the AffectAutoLimits name-value argument. geoiconchart(lat,lon,AffectAutoLimits=false)
Specify information about the feature, for use in information balloons, by using the FeatureName and Description name-value arguments. wmmarker(lat,lon,FeatureName=fn,Description=d)	Display information about the line data by using custom data tips. For an example that shows how to create custom data tips, see Create Custom Data Tips.

The geoiconchart function creates an IconChart object. For information about the properties of IconChart objects, see IconChart Properties.

By default, the geoiconchart function uses a different icon size than the wmmarker function. To use the same icon size as wmmarker, set the SizeData property to 32.

geoiconchart(lat,lon,SizeData=32)

To display multiple data sets using the same geographic axes object, set the hold state to on by using the hold function.

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

R2021b: Display data from geospatial tables

The wmmarker function accepts geospatial tables as input.