exponenta event banner

addCustomBasemap

Добавить пользовательскую базовую карту

Описание

addCustomBasemap(basemapName,URL) добавляет пользовательскую базовую карту, заданную URL в список базовых карт, доступных для использования с функциями отображения. basemapName - это имя, которое вы выбираете для вызова пользовательской базовой карты. Добавленные базовые карты остаются доступными для использования в будущих сессиях MATLAB ®.

пример

addCustomBasemap(___,Name,Value) определяет пары «имя-значение», которые задают дополнительные параметры базовой карты.

Примеры

свернуть все

Добавьте пользовательскую базовую карту для просмотра расположений на базовой карте OpenTopoMap ®, а затем удалите пользовательскую базовую карту изsiteviewer.

Инициализировать переменные моделирования для:

  • Определите имя, которое будет использоваться для указания пользовательской базовой карты.

  • Укажите веб-сайт, предоставляющий данные карты. Первый символ URL указывает, какой сервер использовать для получения данных. Для балансировки нагрузки поставщик имеет три сервера, которые можно использовать: a, b или c.

  • Создайте атрибуцию для отображения на карте, которая дает кредит поставщику данных карты. Поставщики веб-карт могут определять конкретные требования для атрибуции.

  • Определите отображаемое имя для пользовательской карты.

name = 'opentopomap';
url = 'a.tile.opentopomap.org';
copyright = char(uint8(169));
attribution = copyright + "OpenStreetMap contributors";
displayName = 'Open Topo Map';

Использовать addCustomBasemap чтобы загрузить пользовательскую базовую карту, а затем создать siteviewer объект, загружающий пользовательскую базовую карту.

addCustomBasemap(name,url,'Attribution',attribution','DisplayName',displayName)
viewer = siteviewer('Basemap',name);

После добавления пользовательской базовой карты в siteviewer, пользовательская карта доступна для будущих вызовов siteviewer. Обратите внимание на 'Open Topo Map' в окне Imagery вкладка.

siteviewer;

Использовать removeCustomBasemap для удаления пользовательской базовой карты из будущих вызовов siteviewer. Обратите внимание на 'Open Topo Map' значок больше не доступен в Imagery вкладка.

removeCustomBasemap(name)
siteviewer;

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

свернуть все

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

Пример: 'openstreetmap'

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

URL-адрес параметризованной карты, указанный как строковый скалярный или символьный вектор. Параметризованный URL-адрес - это индекс фрагментов карты, отформатированный как ${z}/${x}/${y}.png или {z}/{x}/{y}.png, где:

  • ${z} или {z} - уровень масштабирования плитки.

  • ${x} или {x} - индекс столбца плитки.

  • ${y} или {y} - индекс строки плитки.

Пример: 'https://hostname/${z}/${x}/${y}.png'

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

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

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: addCustomBasemap(basemapName,URL,'Attribution',attribution)

Атрибуция пользовательской базовой карты, указанной как разделенная запятыми пара, состоящая из 'Attribution' и строковый скаляр, строковый массив, символьный вектор или клеточный массив символьных векторов. Если хост 'localhost', или если URL содержит только IP-номера, укажите пустое значение (''). Чтобы создать многострочный атрибут, укажите строковый массив или нескалярный массив ячеек символьных векторов.

Если атрибут не указан, по умолчанию используется атрибут 'Tiles courtesy of DOMAIN_NAME_OF_URL', где addCustomBasemap функция получает имя домена из URL входной аргумент.

Пример: 'Credit: U.S. Geological Survey'

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

Отображаемое имя пользовательской базовой карты, указанной как разделенная запятыми пара, состоящая из 'DisplayName' и строковый скалярный или символьный вектор.

Пример: 'OpenStreetMap'

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

Максимальный уровень масштабирования базовой карты, определяемый как разделенная запятыми пара, состоящая из 'MaxZoomLevel' и целое число в диапазоне [0, 25].

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

Совет

  • Вы можете найти мозаичные веб-карты от различных поставщиков, таких как OpenStreetMap ®, USGS National Map, Mapbox, DigityGlobe, Esri ® ArcGIS Online, Управления геопространственной информации Японии (GSI) и HERE Technologies. Соблюдайте условия соглашения с поставщиками карт и включите точную атрибуцию используемых карт.

  • Чтобы получить доступ к списку доступных базовых карт, нажмите клавишу TAB, прежде чем указать базовую карту в функции печати.