exponenta event banner

wmmarker

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

Описание

пример

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

пример

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

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

пример

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

h = wmmarker(___) возвращает дескриптор для наложения.

Примеры

свернуть все

Показать маркер в Лондоне, Англия. Нет текущей веб-карты, поэтому wmmarker функция создает одну.

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

wmmarker добавляет имя маркера в список наложений в Диспетчере слоев. По умолчанию используется имя «Наложение маркера 1».

Считывание данных образца элемента в вектор географической точки.

p = gpxread('boston_placenames');

Отображение маркеров в элементах, определенных в векторе географической точки. Дополнительно укажите имена элементов и имена наложения. Нет текущей веб-карты, поэтому wmmarker функция создает одну. Щелкните маркер, чтобы просмотреть информацию о элементе, включая его имя.

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

Определите местоположение. В этом примере укажите координаты MathWorks ®.

lat =  42.299827;
lon = -71.350273;

Укажите имя и текст для отображения в номере позиции описания. Этот код делает URL-адрес MathWorks ссылкой.

name = 'MathWorks';
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>');

Укажите пользовательский значок маркера.

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

Отображение маркера на веб-карте с помощью wmmarker. Укажите Description, FeatureName, Icon, и OverlayName пары имя-значение. Обратите внимание на пользовательский значок. Отобразите включенный текст, щелкнув маркер. Обратите внимание на форматирование HTML в описании.

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

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

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

Преобразовать геострукт, возвращенный 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');
wmmarker(p,'Description',attribspec,... 
	     'OverlayName','Tsunami Events')
wmzoom(2)

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

свернуть все

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

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

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

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

Географические элементы, определяемые как вектор геопоинта.

Веб-карта, указанная как дескриптор веб-карты. [1 ]

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

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. 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

[1] Выравнивание границ и меток областей является представлением функции, предоставляемой поставщиками данных, и не подразумевает одобрения MathWorks.