Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

wmmarker

Display geographic marker on web map

Syntax

  • wmmarker(lat,lon)
    example
  • wmmarker(P)
    example
  • wmmarker(wm,___)
  • wmmarker(__,Name,Value)
    example
  • h = wmmarker(___)

Description

example

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.

example

wmmarker(P) displays marker overlay specified by the latitude and longitude data in the geopoint vector 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.

example

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

collapse all

Add a marker positioned at London, England.

lat = 51.5187666404504;
lon = -0.130003487285315;
wmmarker(lat, lon);

wmmarker adds the marker to the list of overlays in the Layer Manager. In the illustration, note the default marker overlay name.

Read feature data into geopoint vector.

p = gpxread('boston_placenames');

Draw markers at features defined in the geopoint vector. wmmarker creates the web map. In the illustration, note the feature name in the balloon and the overlay name in the Layer Manager, which were specified in the call to wmmarker.

wmmarker(p, 'FeatureName', p.Name, 'OverlayName', 'Boston Placenames')

Define location. For this example, the coordinates mark the location of The MathWorks, Inc.

lat =  42.299827;
lon = -71.350273;

Specify text in description balloon and name. This code makes the MathWorks URL a link.

description = sprintf('%s<br>%s</br><br>%s</br>',...
                      '3 Apple Hill Drive', 'Natick, MA. 01760', ...
                      '<a href="https://www.mathworks.com" target="_blank">https://www.mathworks.com</a>');
name = 'The MathWorks, Inc.';

Specify custom icon.

iconDir = fullfile(matlabroot,'toolbox','matlab','icons');
iconFilename = fullfile(iconDir, 'matlabicon.gif');

Draw marker on web map, specifying Description, FeatureName, Icon, and OverlayName. wmmarker creates the web map. In the illustration, note the custom icon and the HTML formatting in the description.

wmmarker(lat, lon, 'Description', description, ...
                   'FeatureName', name,... 
                   'Icon', iconFilename,... 
                   'OverlayName', name);

Import a shapefile representing tsunami (tidal wave) events reported over several decades, tagged geographically by source location.

S = shaperead('tsunamis', 'UseGeoCoords', true);

Convert the geostruct returned by shaperead into a geopoint vector.

p = geopoint(S);

Create an attribute spec and modify it to define a table of values to display in the feature balloon, including year, cause, country, location, and maximum height. The attribute spec defines the format of the expected value for each field.

attribspec = makeattribspec(p);

desiredAttributes = ...
       {'Max_Height', 'Cause', 'Year', 'Location', 'Country'};
allAttributes = fieldnames(attribspec);
attributes = setdiff(allAttributes, desiredAttributes);
attribspec = rmfield(attribspec, attributes);
attribspec.Max_Height.AttributeLabel = '<b>Maximum Height</b>';
attribspec.Max_Height.Format = '%.1f Meters';
attribspec.Cause.AttributeLabel = '<b>Cause</b>';
attribspec.Year.AttributeLabel = '<b>Year</b>';
attribspec.Year.Format = '%.0f';
attribspec.Location.AttributeLabel = '<b>Location</b>';
attribspec.Country.AttributeLabel = '<b>Country</b>';

Create a web map, specifying the base layer. Then add the marker overlay. In the illustration, note the table containing the data you specified in the attribute spec.

webmap('ocean basemap', 'WrapAround', false);
wmmarker(p, 'Description', attribspec,... 
	           'OverlayName', 'Tsunami Events')
wmzoom(2)

Input Arguments

collapse all

Latitudes of points, specified as a matrix.

Data Types: single | double

Longitudes of points, specified as a matrix.

Data Types: single | double

Geographic features, specified as a geopoint vector.

Web map, specified as a web map handle.

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside single quotes (' '). You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

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

collapse all

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

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

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

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 filename is not in the current folder, or in a folder on the MATLAB® path, specify a full or relative pathname. If you specify an Internet URL it must include the protocol type. If the icon filename 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

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 of icon, specified as the comma-separated pair consisting of 'Color' and a MATLAB Color Specification (ColorSpec), a cell array of color names, or a numeric array. The color is applied to the icon when a custom icon file has not been specified, otherwise it is ignored. The default value is 'red'. If the value is a cell array, it must be the same length as LAT and LON, or P. If the value is a numeric array, it must be 1-by-3 or M-by-3 where M is the length of lat and lon or P.

  • If the value is a cell array, it must be scalar or the same length as P.

  • If the value is a numeric array, it must be an M-by-3 where M is either 1 or the length of P.

Data Types: double | char | cell

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

collapse all

Handle to marker overlay, returned as a scalar.

Introduced in R2013b

Was this topic helpful?