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(___) возвращает указатель в наложение.

Примеры

свернуть все

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

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

wmmarker добавляет имя маркера в список наложений в Диспетчере слоев. Имя по умолчанию Marker Overlay 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)

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

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');
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 изменяются в соответствии со спецификацией. Значение по умолчанию является пустым символьным вектором (''). Если значение является структурой, атрибут spec применяется к атрибутам каждой функции P и проигнорировали с lat и lon вход.

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

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

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

Имя слоя наложения, заданное как разделенная разделенными запятой парами, состоящая из 'OverlayName' и вектор символов. wmmarker вставляет имя в Диспетчер слоев под элементом Overlays. Диспетчер слоев - это инструмент, который появляется в правой части системы координат веб-карты. Имя по умолчанию является 'Marker Overlay 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' и спецификация цвета MATLAB (ColorSpec), массив ячеек названий цвета или числовой массив. Цвет применяется к значку, когда пользовательский файл значка не задан, в противном случае он игнорируется. Значение по умолчанию является 'red'. Если значение является массивом ячеек, это должна быть та же длина, что и 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.

Mapping Toolbox

Поддержка