kmlwriteline

Запишите географические данные о линии в файл KML

Синтаксис

kmlwriteline(filename,latitude,longitude)

kmlwriteline(filename,latitude,longitude,altitude)

kmlwriteline(___,Name,Value)

Описание

kmlwriteline(filename,latitude,longitude) пишут географические данные о линии, заданные latitude и longitude к файлу, заданному filename в формате Языка разметки замочной скважины (KML). kmlwriteline создает KML Placemark элемент для каждой линии, с помощью значений широты и долготы в качестве координат точек, которые задают линию. kmlwriteline устанавливает высотные значения, сопоставленные с линией к 0 и устанавливает высотную интерпретацию на 'clampToGround'.

kmlwriteline(filename,latitude,longitude,altitude) использует значения latitude, longitude, и altitude установить координаты точек, которые задают линию. Когда вы задаете высотное значение, kmlwriteline устанавливает AltitudeMode припишите 'relativeToSeaLevel'.

пример

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

Примеры

свернуть все

Запишите данные о линии в файл KML

Загрузите географические данные, описывающие береговые линии.

load coastlines

Задайте имя файла KML, который вы хотите создать.

 filename = 'coastlines.kml';

Запишите данные о линии в файл, задав цвет и ширину линии.

kmlwriteline(filename, coastlat, coastlon, 'Color','black', ...
       'LineWidth', 3);

Получите журнал дорожки GPS из файла GPX и записи данных к файлу KML

Считайте журнал дорожки из файла GPX. gpxread возвращает данные как вектор геоточки.

points = gpxread('sample_tracks');

Получите широту, долготу и высотные значения из данных.

lat = points.Latitude;
lon = points.Longitude;
alt = points.Elevation;

Задайте имя файла KML, который вы хотите создать.

filename = 'track.kml';

Запишите географические данные о линии в файл, задав описание и имя.

kmlwriteline(filename,lat, lon, alt, ...
       'Description', points.Metadata.Name, 'Name', 'Track Log');

Отобразите равномерно распределенный Waypoints вдоль двух больших круговых дорожек

Считайте данные о дорожке в вектор геоточки.

cities = geopoint(shaperead('worldcities','UseGeoCoords',true));

Получите широту, долготу и высотные значения из данных. Пример использует Лондон и Нью-Йорк.

city1 = 'London';
city2 = 'New York';
pt1 = cities(strcmp(city1,cities.Name));
pt2 = cities(strcmp(city2,cities.Name));
lat1 = pt1.Latitude;
lon1 = pt1.Longitude;
lat2 = pt2.Latitude;    
lon2 = pt2.Longitude;
nlegs = 20;
[lat,lon] = gcwaypts(lat1,lon1,lat2,lon2,nlegs);
midpoint = nlegs/2;
altscale = 5000;
alt = [0:midpoint midpoint-1:-1:0] * altscale;

Задайте представление с помощью LookAt значения параметров.

lookLat = 49.155804;
lookLon = -56.698494;
lookAt = geopoint(lookLat, lookLon);
lookAt.Range = 2060400;
lookAt.Heading = 10;
lookAt.Tilt = 70;

Запишите географические данные о линии в два файла KML, задав цвет, ширину и представление. Высотным значениям отображений дорожки и другому зафиксировали дорожку к земле.

width = 4;
filename1 = 'altitudetrack.kml';
kmlwriteline(filename1,lat,lon,alt,'Color','k','LineWidth',width)

filename2 = 'groundtrack.kml';
kmlwriteline(filename2,lat,lon,alt,'Color','w','LineWidth',width, ...
       'LookAt',lookAt,'AltitudeMode','clampToGround')

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

свернуть все

`filename` — Имя выходного файла
вектор символов | строковый скаляр

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

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

`latitude` — Широты точек, которые задают линию
вектор в области значений `[-90 90]`

Широты точек, которые задают линию в виде вектора в области значений [-90 90].

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

`longitude` — Долготы точек, которые задают линию
вектор

Долготы точек, которые задают линию в виде вектора. Значения долготы автоматически переносят к области значений [-180, 180].

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

`altitude` — Высота точек, которые задают линию
0 (значений по умолчанию) | скаляр или вектор

Высота точек, которые задают линию в виде скаляра или вектора. Единица измерения является метрами.

Если скаляр, kmlwriteline применяет значение к каждой точке.
Если вектор, необходимо задать высотное значение для каждой точки. Таким образом, вектор должен иметь ту же длину как latitude и longitude.

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

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

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

Пример: 'Name','Point Reyes'

`Name` — Метка линии отображена в средстве просмотра
`'Line N'` где `N` индекс линии (значение по умолчанию) | строковый скаляр | вектор символов

Метка линии, отображенной в средстве просмотра в виде строкового скаляра или вектора символов.

Если линия содержит NaN значения, kmlwriteline помещает линейные сегменты в папке пометили 'Line 1'. kmlwriteline помечает линейные сегменты 'Segment N', где N значение индекса линейного сегмента.

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

`Description` — Содержимое, которое будет отображено в воздушном шаре описания линии
строковый скаляр | вектор символов

Содержимое, которое будет отображено в воздушном шаре описания линии в виде строкового скаляра или вектора символов. Описание появляется в воздушном шаре описания, когда пользователь кликает или по имени функции в панели Гугл Ерс-Плэйсез или по линии в окне средства просмотра.

Можно включать основной HTML, повышают, однако, Google Earth применяет некоторый HTML, форматирующий автоматически. Например, Google Earth заменяет новые строки на теги разрыва строк и заключает допустимые URL в теги привязки, чтобы сделать их гиперссылками. Чтобы видеть примеры HTML-тэгов, распознанных Google Earth, просмотрите https://earth.google.com.

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

`Color` 'LineColor'
заданный средством просмотра (значение по умолчанию) | название цвета | триплет RGB | `'none'`

Цвет линии в виде одной из этих опций.

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

Если вы не задаете цвет линии или задаете 'none', затем kmlwriteline функция не включает спецификацию цветов в файл, и средство просмотра задает цвет.

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

Название цвета	Краткое название	Триплет RGB
`'red'`	`'r'`	[1 0 0]
`'green'`	`'g'`	[0 1 0]
`'blue'`	`'b'`	[0 0 1]
`'cyan'`	`'c'`	[0 1 1]
`'magenta'`	`'m'`	[1 0 1]
`'yellow'`	`'y'`	[1 1 0]
`'black'`	`'k'`	[0 0 0]
`'white'`	`'w'`	[1 1 1]

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

`Alpha` — Прозрачность линии
1 (значение по умолчанию) | числовой скаляр в области значений `[0 1]`

Прозрачность линии в виде числового скаляра в области значений [0 1]. Значение по умолчанию, 1, указывает, что линия полностью непрозрачна.

`LineWidth` — Ширина линии в пикселях
заданный средством просмотра (значение по умолчанию) | положительный числовой скаляр

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

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

`AltitudeMode` — Интерпретация высотных значений
`'clampToGround'` (значение по умолчанию) | `'relativeToGround'` | `'relativeToSeaLevel'`

Интерпретация высотных значений в виде одного из следующего:

Значение	Описание
`'clampToGround'`	Проигнорируйте высотные значения и установите функцию на земле. Интерпретация по умолчанию, когда вы не задаете `altitude` значения.
`'relativeToGround'`	Установите высотные значения относительно фактического наземного вертикального изменения конкретной функции.
`'relativeToSeaLevel'`	Установите высотные значения относительно уровня моря, независимо от фактических значений вертикального изменения ландшафта ниже функции. Интерпретация по умолчанию, когда вы задаете высотные значения. Названный `'absolute'` в терминологии KML.

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

`LookAt` — Положение виртуальной камеры (глаз) относительно просматриваемого объекта
вектор геоточки

Положение виртуальной камеры (глаз) относительно объекта, просматриваемого в виде вектора геоточки. Поля вектора геоточки задают представление. LookAt ограничивается рассмотрением вниз функции. Чтобы наклонить виртуальную камеру, чтобы изучить выше горизонта небо, используйте Camera параметр.

PropertyName	Описание	Тип данных
`Latitude`	Широта линии камера смотрит на в градусах	Скаляр дважды, от-90 до 90
`Longitude`	Долгота линии камера смотрит на в градусах	Скаляр дважды, от −180 до 180
`Altitude`	Высота линии камера смотрит на от поверхности Земли в метрах	Числовой скаляр
`Heading`	Направление камеры (азимут), в градусах (дополнительный)	Скалярный числовой `[0 360]`, `0` по умолчанию (истинный Север)
`Tilt`	Угол между направлением `LookAt` положение и нормальное на поверхность Земли, в градусах (дополнительной)	Скалярный числовой `[0 90]`, `0` по умолчанию (непосредственно выше)
`Range`	Расстояние в метрах от точки задано `latitude`, `longitude`, и `altitude` к позиции камеры.	Скалярный числовой, `0` по умолчанию
`AltitudeMode`	Интерпретация высотного (дополнительного) значения камеры	`'relativeToSeaLevel'`, `'clampToGround'`, `'relativeToGround'` (по умолчанию)

`Camera` — Положение виртуальной камеры относительно поверхности Земли
вектор геоточки

Положение виртуальной камеры (глаз) относительно поверхности Земли в виде вектора геоточки. Поля вектора геоточки, описанного ниже, задают представление. Camera обеспечивает полные 6 управления степенями свободы представлением, таким образом, можно позиционировать камеру на пробеле и затем вращать его вокруг x-, y- и осей z-. Можно наклонить поле зрения камеры так, чтобы вы изучили выше горизонта небо.

PropertyName	Описание	Тип данных
`Latitude`	Широта виртуальной камеры (глаз), в градусах	Скаляр дважды, в области значений `[-90 90]`
`Longitude`	Долгота виртуальной камеры, в градусах,	Скаляр дважды, в области значений `[-180 180]`.
`Altitude`	Расстояние виртуальной камеры от поверхности Земли, в метрах	Числовой скаляр
`Heading`	Направление (азимут), в градусах (дополнительный)	Скалярный числовой `[0 360]`, `0` по умолчанию (истинный Север)
`Tilt`	Вращение камеры вокруг Оси X, в градусах (дополнительной)	Скалярный числовой `[0 180]`, `0` по умолчанию (непосредственно выше)
`Roll`	Вращение камеры в градусах вокруг (дополнительной) оси Z	Числовой скаляр, в области значений `[-180 180]`, `0` по умолчанию
`AltitudeMode`	Задает, как высота камеры интерпретирована (дополнительная)	`'relativeToSeaLevel'`, `'clampToGround'`, `'relativeToGround'` (значение по умолчанию)

Советы

Если вы не видите свою линию, установите AltitudeMode к 'clampToGround'. Если линия появляется, то у вас может быть проблема с вашим высотным значением.
Можно просмотреть файлы KML с браузером Google Earth™, который должен быть установлен на компьютере.
Для Windows используйте winopen функция:
```
winopen(filename)
```
Для Linux, если имя файла является частичным путем, используют следующие команды:
```
cmd = 'googleearth ';
fullfilename = fullfile(pwd, filename);   
system([cmd fullfilename])
```
Для Mac, если имя файла является частичным путем, используют следующие команды:
```
cmd = 'open -a Google\ Earth '
fullfilename = fullfile(pwd, filename);   
system([cmd fullfilename])
```
Вы можете также файлы представления KML с браузером Google Maps™. Файл должен быть расположен на веб-сервере, который доступен из Интернета. Частный сервер интранет не будет достаточен, потому что сервер Google должен смочь получить доступ к URL, который вы обеспечиваете. Следующее является шаблоном для использования Google Maps. Замените your-web-server-path с вещественным значением.
```
GMAPS_URL = 'http://maps.google.com/maps?q=';
KML_URL = 'http://your-web-server-path';
web([GMAPS_URL KML_URL])
```

Введенный в R2013a

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

kmlwriteline

Синтаксис

Описание

Примеры

Запишите данные о линии в файл KML

Получите журнал дорожки GPS из файла GPX и записи данных к файлу KML

Отобразите равномерно распределенный Waypoints вдоль двух больших круговых дорожек

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

`filename` — Имя выходного файла
вектор символов | строковый скаляр

`latitude` — Широты точек, которые задают линию
вектор в области значений `[-90 90]`

`longitude` — Долготы точек, которые задают линию
вектор

`altitude` — Высота точек, которые задают линию
0 (значений по умолчанию) | скаляр или вектор

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

`Name` — Метка линии отображена в средстве просмотра
`'Line N'` где `N` индекс линии (значение по умолчанию) | строковый скаляр | вектор символов

`Description` — Содержимое, которое будет отображено в воздушном шаре описания линии
строковый скаляр | вектор символов

`Color` 'LineColor'
заданный средством просмотра (значение по умолчанию) | название цвета | триплет RGB | `'none'`

`Alpha` — Прозрачность линии
1 (значение по умолчанию) | числовой скаляр в области значений `[0 1]`

`LineWidth` — Ширина линии в пикселях
заданный средством просмотра (значение по умолчанию) | положительный числовой скаляр

`AltitudeMode` — Интерпретация высотных значений
`'clampToGround'` (значение по умолчанию) | `'relativeToGround'` | `'relativeToSeaLevel'`

`LookAt` — Положение виртуальной камеры (глаз) относительно просматриваемого объекта
вектор геоточки

`Camera` — Положение виртуальной камеры относительно поверхности Земли
вектор геоточки

Советы

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

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

Поддержка

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

kmlwriteline

Синтаксис

Описание

Примеры

Запишите данные о линии в файл KML

Получите журнал дорожки GPS из файла GPX и записи данных к файлу KML

Отобразите равномерно распределенный Waypoints вдоль двух больших круговых дорожек

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

filename — Имя выходного файла вектор символов | строковый скаляр

latitude — Широты точек, которые задают линию вектор в области значений [-90 90]

longitude — Долготы точек, которые задают линию вектор

altitude — Высота точек, которые задают линию 0 (значений по умолчанию) | скаляр или вектор

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

Name — Метка линии отображена в средстве просмотра 'Line N' где N индекс линии (значение по умолчанию) | строковый скаляр | вектор символов

Description — Содержимое, которое будет отображено в воздушном шаре описания линии строковый скаляр | вектор символов

Color 'LineColor' заданный средством просмотра (значение по умолчанию) | название цвета | триплет RGB | 'none'

Alpha — Прозрачность линии 1 (значение по умолчанию) | числовой скаляр в области значений [0 1]

LineWidth — Ширина линии в пикселях заданный средством просмотра (значение по умолчанию) | положительный числовой скаляр

AltitudeMode — Интерпретация высотных значений 'clampToGround' (значение по умолчанию) | 'relativeToGround' | 'relativeToSeaLevel'

LookAt — Положение виртуальной камеры (глаз) относительно просматриваемого объекта вектор геоточки

Camera — Положение виртуальной камеры относительно поверхности Земли вектор геоточки

Советы

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

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

Поддержка

`filename` — Имя выходного файла
вектор символов | строковый скаляр

`latitude` — Широты точек, которые задают линию
вектор в области значений `[-90 90]`

`longitude` — Долготы точек, которые задают линию
вектор

`altitude` — Высота точек, которые задают линию
0 (значений по умолчанию) | скаляр или вектор

`Name` — Метка линии отображена в средстве просмотра
`'Line N'` где `N` индекс линии (значение по умолчанию) | строковый скаляр | вектор символов

`Description` — Содержимое, которое будет отображено в воздушном шаре описания линии
строковый скаляр | вектор символов

`Color` 'LineColor'
заданный средством просмотра (значение по умолчанию) | название цвета | триплет RGB | `'none'`

`Alpha` — Прозрачность линии
1 (значение по умолчанию) | числовой скаляр в области значений `[0 1]`

`LineWidth` — Ширина линии в пикселях
заданный средством просмотра (значение по умолчанию) | положительный числовой скаляр

`AltitudeMode` — Интерпретация высотных значений
`'clampToGround'` (значение по умолчанию) | `'relativeToGround'` | `'relativeToSeaLevel'`

`LookAt` — Положение виртуальной камеры (глаз) относительно просматриваемого объекта
вектор геоточки

`Camera` — Положение виртуальной камеры относительно поверхности Земли
вектор геоточки