KML~KML

import KML from 'ol/format/KML.js';

Формат функций для чтения и записи данных в формате KML.

readFeature будет читать первую функцию из источника KML.

Многогеометрии преобразуются в GeometryCollections, если они являются смесью типов геометрий, и в MultiPoint/MultiLineString/MultiPolygon, если они все одного типа.

new KML(options) format/KML.js, строка 438

Имя	Тип	Описание
`extractStyles`	boolean (по умолчанию true)	Извлекать стили из KML.
`showPointNames`	boolean (по умолчанию true)	Отображать имена в качестве меток для метки, содержащей точки.
`defaultStyle`	Array<Стиль> \| undefined	Стиль по умолчанию. По умолчанию используется тот же стиль, что и в Google Earth.
`writeStyles`	boolean (по умолчанию true)	Записывать стили в KML.
`crossOrigin`	null \| string (по умолчанию 'anonymous')	Атрибут `crossOrigin` для загруженных изображений. Обратите внимание, что вам необходимо предоставить значение `crossOrigin`, если вы хотите получить доступ к данным пикселей с помощью рендерера Canvas.
`iconUrlFunction`	ФункцияUrlИконки \| undefined	Функция, которая принимает строку url и возвращает строку url. Может использоваться для изменения пути к иконке или для подстановки URL-адреса данных, полученного из буфера массива KMZ.

Расширяет

XMLFeature

Методы

readCamera(source){Array<KMLCamera>} format/KML.js, строка 916

Считывает камеры KML.

Имя	Тип	Описание
`source`	Document \| Element \| string	Источник.

Возвращает:

Камеры.

readCameraFromNode(node){Array<KMLCamera>} format/KML.js, строка 951

Имя	Тип	Описание
`node`	Element	Узел.

Возвращает:

Камеры.

readFeature(source, options){Feature} унаследованный format/XMLFeature.js, строка 45

Считывает один объект.

Имя Тип Описание

source

Document | Element | Object | string

Источник.

options

Параметры считывания.

Имя	Тип	Описание
`dataProjection`	ProjectionLike \| undefined	Проекция данных, которые мы считываем. Если не указана, проекция будет получена из данных (если возможно) или задана для формата (если задана). Если проекцию нельзя получить из данных и для формата не задана проекция, объекты не будут перепроектированы.
`extent`	Extent \| undefined	Область тайла в единицах карты тайла, который считывается. Это необходимо только при считывании данных с пикселями тайла в качестве единиц геометрии. При конфигурировании, необходимо указать область тайла с указанием координат и области пикселей тайла.
`featureProjection`	ProjectionLike \| undefined	Проекция геометрий объектов, созданных читателем формата. Если не указана, объекты будут возвращены в исходной проекции.

Возвращает:

Объект.

readFeatures(source, options){Array<Feature>} унаследованный format/XMLFeature.js, строка 93

Считывает все объекты из коллекции объектов.

Имя Тип Описание

source

Document | Element | Object | string

Источник.

options

Параметры.

Имя	Тип	Описание
`dataProjection`	ProjectionLike \| undefined	Проекция данных, которые мы считываем. Если не указана, проекция будет получена из данных (если возможно) или задана для формата (если задана). Если проекцию нельзя получить из данных и для формата не задана проекция, объекты не будут перепроектированы.
`extent`	Extent \| undefined	Область тайла в единицах карты тайла, который считывается. Это необходимо только при считывании данных с пикселями тайла в качестве единиц геометрии. При конфигурировании, необходимо указать область тайла с указанием координат и области пикселей тайла.
`featureProjection`	ProjectionLike \| undefined	Проекция геометрий объектов, созданных читателем формата. Если не указана, объекты будут возвращены в исходной проекции.

Возвращает:

Объекты.

readName(source){string | undefined} format/KML.js, строка 708

Считывает имя KML.

Имя	Тип	Описание
`source`	Document \| Element \| string	Источник.

Возвращает:

Имя.

readNetworkLinks(source){Array.<Object>} format/KML.js, строка 773

Считывает сетевые ссылки KML.

Имя	Тип	Описание
`source`	Document \| Element \| string	Источник.

Возвращает:

Сетевые ссылки.

readProjection(source){Projection} унаследованный format/XMLFeature.js, строка 194

Считывает проекцию из источника.

Имя	Тип	Описание
`source`	Document \| Element \| Object \| string	Источник.

Возвращает:

Проекция.

readRegion(source){Array.<Object>} format/KML.js, строка 843

Чтение областей KML.

Имя	Тип	Описание
`source`	Документ \| Элемент \| строка	Источник.

Возвращает:

Области.

readRegionFromNode(node){Массив.<Объект>} format/KML.js, строка 878

Имя	Тип	Описание
`node`	Элемент	Узел.

Возвращает:

Область.

writeFeatures(features, options){строка} унаследованный format/XMLFeature.js, строка 258

Кодировать массив объектов как строку.

Имя Тип Описание

features

Массив<Объект>

Объекты.

options

Опции записи.

Имя	Тип	Описание
`dataProjection`	Проекция \| undefined	Проекция данных, которые мы записываем. Если не указано, используется проекция формата (если она задана). Если для формата не задана проекция, объекты возвращаются в исходной проекции.
`featureProjection`	Проекция \| undefined	Проекция геометрий объектов, которые будут сериализованы записывателем формата. Если не указано, предполагается, что геометрии находятся в проекции, если она задана; другими словами, они не преобразуются.
`rightHanded`	логическое значение \| undefined	При записи геометрий следует правилу правой руки для ориентации линейных колец. Это означает, что у полигонов будут внешние кольца против часовой стрелки и внутренние кольца по часовой стрелке. По умолчанию координаты сериализуются так, как они предоставлены при создании. Если значение true, будет применено правило правой руки. Если значение false, будет применено правило левой руки (по часовой стрелке для внешних и против часовой стрелки для внутренних колец). Обратите внимание, что не все форматы поддерживают это. Формат GeoJSON использует это свойство при записи геометрий.
`decimals`	число \| undefined	Максимальное количество десятичных знаков для координат. Координаты хранятся в формате float, но арифметика с плавающей точкой может создавать координаты с большим количеством десятичных знаков, чего обычно не требуется на выходе. Установите здесь число, чтобы округлить координаты. Также может быть использовано для обеспечения того, чтобы координаты, прочитанные из файла, могли быть записаны обратно с тем же числом десятичных знаков. По умолчанию округление не выполняется.

Возвращает:

Результат.

writeFeaturesNode(features, options){Узел} format/KML.js, строка 984

Кодировать массив объектов в формате KML в виде узла XML. GeometryCollections, MultiPoints, MultiLineStrings и MultiPolygons выводятся как MultiGeometries.

Имя Тип Описание

features

Массив<Объект>

Объекты.

options

Опции.

Имя	Тип	Описание
`dataProjection`	Проекция \| undefined	Проекция данных, которые мы записываем. Если не указано, используется проекция формата (если она задана). Если для формата не задана проекция, объекты возвращаются в исходной проекции.
`featureProjection`	Проекция \| undefined	Проекция геометрий объектов, которые будут сериализованы записывателем формата. Если не указано, предполагается, что геометрии находятся в проекции, если она задана; другими словами, они не преобразуются.
`rightHanded`	логическое значение \| undefined	При записи геометрий следует правилу правой руки для ориентации линейных колец. Это означает, что у полигонов будут внешние кольца против часовой стрелки и внутренние кольца по часовой стрелке. По умолчанию координаты сериализуются так, как они предоставлены при создании. Если значение true, будет применено правило правой руки. Если значение false, будет применено правило левой руки (по часовой стрелке для внешних и против часовой стрелки для внутренних колец). Обратите внимание, что не все форматы поддерживают это. Формат GeoJSON использует это свойство при записи геометрий.
`decimals`	число \| undefined	Максимальное количество десятичных знаков для координат. Координаты хранятся в формате float, но арифметика с плавающей точкой может создавать координаты с большим количеством десятичных знаков, чего обычно не требуется на выходе. Установите здесь число, чтобы округлить координаты. Также может быть использовано для обеспечения того, чтобы координаты, прочитанные из файла, могли быть записаны обратно с тем же числом десятичных знаков. По умолчанию округление не выполняется.

Возвращает:

Узел.