wmmarker

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

Описание

пример

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

пример

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

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

пример

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

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

Примеры

свернуть все

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

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

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

Считайте координаты и имена местоположений в Бостоне, MA, как геопространственная таблица.

P = readgeotable("boston_placenames.gpx");

Отобразите данные как маркеры на веб-карте. Задайте имена функции и наложите имена с помощью аргументов name-value. wmmarker функция создает новую веб-карту, когда нет никакой текущей веб-карты.

wmmarker(P,"FeatureName",P.Name,"OverlayName","Boston Placenames")

Нажмите на маркер, чтобы видеть информацию о функции, включая ее имя.

Задайте местоположение. В данном примере задайте координаты MathWorks®.

lat =  42.299827;
lon = -71.350273;

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

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Значок, и OverlayName пары "имя-значение". Отметьте пользовательский значок. Отобразите текст вы включенный путем нажатия на маркер. Отметьте форматирование HTML в описании.

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

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

GT = readgeotable("tsunamis.shp","CoordinateSystemType","geographic");

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

attribspec = makeattribspec(GT);

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(GT,"Description",attribspec,... 
	     "OverlayName","Tsunami Events")
wmzoom(2)

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

свернуть все

Широты точек в виде матрицы.

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

Долготы точек в виде матрицы.

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

Географические особенности в виде одного из следующего:

Веб-карта в виде веб-указателя карты.[1]

Аргументы name-value

Задайте дополнительные разделенные запятой пары 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 вставляет имя в менеджере по Слою под элементом Оверлейных программ. Менеджер по Слою является инструментом, который появляется на правой стороне веб-системы координат карты. Имя по умолчанию является 'Наложением Маркера N' где N номер, присвоенный этому наложению.

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

Имя функции в виде разделенной запятой пары, состоящей из 'FeatureName' и вектор символов или массив ячеек из символьных векторов. Имя появляется в воздушном шаре функции, когда пользователь нажимает на функцию в веб-карте. Значением по умолчанию является 'OverlayName : Укажите 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' и одна из этих опций.

  • Название цвета, такое как 'red' или краткое название, такое как 'r'.

  • Триплет RGB, который является трехэлементным вектором-строкой, элементы которого задают интенсивность красных, зеленых, и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; например, [0.4 0.6 0.7].

  • Массив ячеек названий цвета, таких как {'red','green','blue'} или {'r','g','b'}.

  • Вектор строки из названий цвета, таких как ["red" "green" "blue"] или ["r" "g" "b"].

  • Матрица A триплетов RGB, которая является матрицей с тремя столбцами, в которой каждой строкой является триплет RGB.

Путем вы указываете, что цвет зависит от схемы требуемого цвета.

  • Чтобы применить тот же цвет ко всем значкам, задайте одно название цвета или триплет RGB.

  • Чтобы применить различный цвет к каждому значку, задайте массив ячеек названий цвета, вектор строки из названий цвета или матрицу триплетов RGB. Количество цветов и триплетов RGB должно совпадать с длиной lat и lon или P.

Если вы задаете файл пользовательского значка, то wmmarker функция игнорирует этот аргумент.

Эта таблица содержит названия цвета и эквивалентные триплеты RGB для некоторых простых цветов.

Название цветаКраткое названиеТриплет RGBВнешний вид
'red''r'[1 0 0]

Sample of the color red

'green''g'[0 1 0]

Sample of the color green

'blue''b'[0 0 1]

Sample of the color blue

'cyan' 'c'[0 1 1]

Sample of the color cyan

'magenta''m'[1 0 1]

Sample of the color magenta

'yellow''y'[1 1 0]

Sample of the color yellow

'black''k'[0 0 0]

Sample of the color black

'white''w'[1 1 1]

Sample of the color white

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

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

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

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

свернуть все

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

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

| | | | | | | |

Введенный в R2013b

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