Exponenta Banner

wmmarker

Отобразите географический маркер на веб-карте

свернуть все на странице

Синтаксис

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

Описание

пример

wmmarker(lat,lon) отображает наложение маркера в точках, заданных lat и lon на текущей веб-карте. Если нет никакой текущей веб-карты, wmmarker создает тот. wmmarker сосредотачивает карту так, чтобы все векторные оверлейные программы на веб-карте были видимы. Маркер также называется map pin.

пример

wmmarker(P) наложение маркера отображений задано данными о широте и долготе в векторе геоточки P. Каждый элемент P задает одно наложение маркера.

wmmarker(wm,___) отображает наложение в веб-карте, заданной веб-указателем карты, wm.

пример

wmmarker(__,Name,Value) задает пары "имя-значение", которые устанавливают дополнительные свойства отображения. Названия параметра могут быть сокращены и нечувствительные к регистру.

h = wmmarker(___) возвращает указатель на наложение.

Примеры

свернуть все

Добавьте маркер, расположенный в Лондон, Англия. 

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

wmmarker добавляет маркер в список оверлейных программ в менеджере по Слою. На рисунке отметьте имя наложения маркера по умолчанию.

Считайте данные о функции в вектор геоточки.

p = gpxread('boston_placenames');

Чертите маркеры в функциях, заданных в векторе геоточки. wmmarker создает веб-карту. На рисунке отметьте имя функции в воздушном шаре и имя наложения в менеджере по Слою, которые были заданы в вызове wmmarker.

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

Задайте местоположение. В данном примере координаты отмечают местоположение MathWorks, Inc.

lat =  42.299827;
lon = -71.350273;

Задайте текст в воздушном шаре описания и имени. Этот код делает MathWorks URL ссылкой.

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.';

Задайте пользовательский значок. 

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

Чертите маркер на веб-карте, задавая Description, FeatureName, Icon и OverlayName. wmmarker создает веб-карту. На рисунке отметьте пользовательский значок и форматирование HTML в описании.

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

Импортируйте файл форм, представляющий цунами (приливная волна) события, о которых сообщают за несколько десятилетий, помеченных географически исходным местоположением.

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

Преобразуйте геоstruct, возвращенный shaperead в вектор геоточки.

p = geopoint(S);

Создайте спецификацию атрибута и измените ее, чтобы задать таблицу значений, чтобы отобразиться в воздушном шаре функции, включая год, причину, страну, местоположение и максимальную высоту. Спецификация атрибута задает формат ожидаемого значения для каждого поля.

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

Создайте веб-карту, задав базовый слой. Затем добавьте наложение маркера. На рисунке отметьте таблицу, содержащую данные, которые вы задали в спецификации атрибута.

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

Входные параметры

свернуть все

Широты точек, заданных как матрица.

Типы данных: single | double

Долготы точек, заданных как матрица.

Типы данных: single | double

Географические особенности, заданные как вектор геоточки.

Веб-карта, заданная как веб-указатель карты.

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: wmmarker(lat,lon,'Autofit',true)

Наложите видимость, заданную как пара, разделенная запятой, состоящая из 'Autofit' и логического флага true или false или числового значения 1 или 0. Если true или 1, wmmarker настраивает пространственную степень карты, чтобы гарантировать, что все векторные оверлейные программы на карте видимы. Если false, wmmarker не настраивает пространственную степень, когда наложение добавляется к карте.

Наложите видимость, заданную как скалярное логическое или числовое значение true (1) или false (0).

  • Если true, wmmarker настраивает пространственную степень карты, чтобы гарантировать, что все векторные оверлейные программы на карте видимы.

  • Если false, wmmarker не настраивает пространственную степень, когда наложение добавляется к карте.

Типы данных: double | logical

Описание функции, заданной как пара, разделенная запятой, состоящая из 'Description' и вектора символов, массива ячеек из символьных векторов или скалярной структуры. Описание задает содержимое, которое wmmarker отображает в воздушном шаре описания функции, который появляется, когда пользователь нажимает на функцию в веб-карте. Элементы описания могут быть или простым текстом или разметкой HTML. Когда вы задаете спецификацию атрибута, отображение в воздушном шаре для полей атрибута P изменяются согласно спецификации. Значение по умолчанию является пустым символьным вектором (''). Если значение является структурой, спецификация атрибута применяется к атрибутам каждой функции P и игнорируется с входом lat и lon.

  • Если значение является массивом ячеек, это - или скаляр или та же длина как P, или lat и lon, и задает описание для каждого маркера.

  • Если значение является структурой, спецификация атрибута применяется к атрибутам каждой функции P и игнорируется с входом lat и lon.

Типы данных: char | struct | cell

Имя слоя наложения, заданного как пара, разделенная запятой, состоящая из 'OverlayName' и вектора символов. wmmarker вставляет имя в менеджере по Слою под элементом Оверлейных программ. Менеджер по Слою является инструментом, который появляется на правой стороне веб-кадра карты. Именем по умолчанию является 'Marker Overlay N', где N является номером, присвоенным этому наложению.

Типы данных: char

Имя функции, заданной как пара, разделенная запятой, состоящая из 'FeatureName' и вектора символов или массива ячеек из символьных векторов. Имя появляется в воздушном шаре функции, когда пользователь нажимает на функцию в веб-карте. Значением по умолчанию является 'OverlayName : Point K', где OverlayName является именем наложения, и K является номером, присвоенным конкретной точке. Если значение является вектором символов, wmmarker применяет его ко всем функциям. Если значение является массивом ячеек, это должен быть скаляр или массив с той же длиной как P или lat и lon.

Типы данных: char | cell

Имя файла пользовательского значка для маркера, заданного как пара, разделенная запятой, состоящая из 'Icon' и вектора символов или массива ячеек из символьных векторов. Если имя файла значка не находится в текущей папке, или в папке на пути MATLAB®, задайте полный или относительный путь. Если вы задаете Интернет URL, он должен включать тип протокола. Если имя файла значка не задано, значок по умолчанию отображен. Для лучших результатов когда это необходимо, чтобы просмотреть значок не по умолчанию, задайте файл PNG, содержащий данные изображения с альфа-маской.

  • Если значение является вектором символов, wmmarker применяет значение ко всем маркерам.

  • Если вы задаете массив ячеек, это должно быть той же длиной как P, или lat и lon, и задает значок для каждого маркера.

Типы данных: char | cell

Масштабный коэффициент для значка, заданного как пара, разделенная запятой, состоящая из 'IconScale' и положительного числового скаляра или вектора.

  • Если значение является скаляром, значение применяется ко всем значкам.

  • Если значение является вектором, оно должно задать значение для каждого значка, и это должна быть та же длина как lat и lon или P.

Типы данных: double

Цвет значка, заданного как пара, разделенная запятой, состоящая из 'Color' и Спецификации цветов MATLAB (ColorSpec), массив ячеек названий цвета или числовой массив. Цвет применяется к значку, когда файл пользовательского значка не был задан, в противном случае это проигнорировано. Значение по умолчанию является 'красным'. Если значение является массивом ячеек, это должна быть та же длина как LAT и LON или P. Если значение является числовым массивом, это должно быть 1 3 или M-by-3, где M является длиной lat и lon или P.

  • Если значение является массивом ячеек, это должен быть скаляр или та же длина как P.

  • Если значение является числовым массивом, это должен быть M-by-3, где M или 1 или длина P.

Типы данных: double | char | cell

Прозрачность маркера, заданного как пара, разделенная запятой, состоящая из 'Alpha' и числового скаляра или вектора. Если вы задаете вектор, он должен включать значение для каждого маркера, то есть, вектор должен быть той же длиной как P. Значение по умолчанию, 1, означает, что маркер полностью непрозрачен.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Выходные аргументы

свернуть все

Наложение маркера, возвращенное как указатель на объект наложения маркера.

Смотрите также

| | | | | | | |

Введенный в R2013b

Документация Mapping Toolbox
Поддержка