Exponenta Banner

addCustomBasemap

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

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

Синтаксис

addCustomBasemap(basemapName,URL)
addCustomBasemap(___,Name,Value)

Описание

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

пример

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

Примеры

свернуть все

Открыть Live Script

Добавьте пользовательскую основную карту, чтобы просмотреть местоположения на базовой основной карте 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-номера, задайте пустое значение (''). Чтобы создать атрибут multiline, задайте строковые массивы или нескалярный массив ячеек из векторов символов.

Если вы не задаете атрибуцию, атрибуцией по умолчанию является 'Плитки предоставлены 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, Mapbox, DigitalGlobe, Esri® ArcGIS Online, Управление геопространственной информации Японии (GSI) и HERE Technologies. Соблюдайте условия соглашения с поставщиками карты и включите точную атрибуцию с используемыми картами.

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

См. также

| | |

Документация Communications Toolbox

Поддержка