Слой в KML (Инструменты Конвертация)

Краткая информация

Конвертирует векторные или растровые слои в формат KML (файл .kmz или .kml). Выходной KML будет содержать перенесенную геометрию объектов Esri, ячейки растров, символы слоев и другие свойства.

Подробнее о поддержке KML в ArcGIS

Использование

Выходные данные инструмента по умолчанию имеют расширение .kmz, которое представляет собой архив или файл .zip, содержащий файл .kml и другие дополнительные файлы. Файл .kmz может быть прочитан многими приложениями, включая ArcGIS Earth и Google Earth.
Можно управлять внешним видом KML следующими двумя способами.
- По умолчанию во всплывающем окне отображается информация из всех видимых полей слоя. Отображение всплывающих окон можно настроить, используя настраиваемые всплывающие окна слоя. Когда всплывающие окна не настроены, при щелчке по объекту KML во всплывающем окне будут отображаться значения поля PopupInfo векторного слоя. Эти значения могут представлять собой числовые или текстовые атрибуты, а также сохраненный в текстовом поле HTML-код.
- Если свойства слоя не заданы, и класс объектов содержит определенные атрибуты (поля), при создании объектов в KML будут использоваться свойства полей, изначально созданные с помощью инструмента KML в слой, включая атрибуты, определяющие способ создания KML. См. Конвертация в KML для получения дополнительной информации о создании KML из атрибутов.
Если входные данные имеют зависимые от масштаба свойства отображения, уменьшите размер выходного файла .kmz, указав подходящее значение параметра Масштаб выходного слоя.
Входной слой будет перепроецирован в WGS84, так как все файлы .kml и .kmz должны использовать эту систему координат. Чтобы гарантировать, чтоб перепроецирование не исказит положение объектов и ячеек растра, возможно, надо будет указать параметр среды географическое преобразование. Также используйте инструмент Проецировать, чтобы перепроецировать входной слой в WGS84 с корректным преобразованием перед конвертированием в KML.
Входные объекты с вложениями будут включены в выходной файл .kmz. Имейте в виду следующие особенности при использовании вложений в файлах .kmz.
- Вложения существенно увеличивают размер выходного файла.
- При использовании файла .kml в клиенте KML, вложения доступны из всплывающих окон KML.
- Вложения можно исключить, отключив параметр среды Поддерживать вложения перед запуском инструмента.
- Не все клиенты KML одинаково поддерживают отображение вложений. Некоторые клиентские приложения KML лучше поддерживают вложения таких типов, как изображения и файлы PDF.
Вложения не будут включены, если выходными данными является файл .kml.
Параметры Выходной масштаб слоя и Размер возвращаемого изображения (пикселы) используются совместно для создания результата в виде листов. Например, для изображения 7000 на 5000 пикселов и параметра Размер возвращаемого изображения (пикселы) со значением 1000 пикселов итоговое изображение будет состоять из 7 x 5 = 35 меньших изображений. Если значение параметра Масштаб выходного слоя равно 1, то каждый фрагмент изображения будет иметь размер 1000 на 1000 пикселов. Если значение параметра Масштаб выходного слоя равно 10, то каждый фрагмент изображения будет иметь размер 100 на 100 пикселов.
Описания доменов будут перенесены в выходные данные при включении параметра среды Перенос описаний доменов полей.

Подпись	Объяснение	Тип данных
Входной слой	Векторный, растровый слой или составной слой, который будет конвертироваться в формат KML.	Feature Layer; Raster Layer; Mosaic Layer; Group Layer; Layer File
Выходной файл (KML или KMZ)	Выходной файл `.kml` или `.kmz`. На выходе может создаваться файл с расширением `.kmz` — это создаст архив или заархивированный файл, или с расширением `.kml` (файл базового формата KML). По умолчанию это выходной файл `.kmz`. Выходные файлы `.kmz` поддерживают растровые слои, символы и другие свойства слоя, вложения и другие сложные объекты. Выходные файлы `.kml` будут использовать основные символы и свойства KML.	File; Workspace; KML Layer
Масштаб выходного слоя (Дополнительный)	Масштаб выходного файла. Для растровых слоев можно использовать значение 0, чтобы создать одно выходное изображение, не разбитое на листы. Если используется значение 1 или больше, оно будет определять выходное разрешение растра. Этот параметр не влияет на слои, которые не являются растровыми.	Double
Возвращает одно составное изображение (Дополнительный)	Указывает, будут ли выходные данные единым составным изображением. Этот параметр применяется, только если вы задаете файл `.kmz` в качестве выходного KML, потому что файлы `.kml` не поддерживают наложение изображений и растров на земле. Отмечено–Выходные данные будут одним составным изображением, представляющим растровые или векторные объекты в исходном слое. Растр драпирован на поверхность как `GroundOverlay`. Выберите эту опцию, чтобы уменьшить размер выходного файла. Если отмечена эта опция, отдельные объекты и слои в файле `.kml` будут недоступны для выборки. Только выходные файлы `.kmz` поддерживают изображения. Не отмечено–Если входные данные содержат векторные объекты, они сохраняются в виде векторов KML.	Boolean
Экстент (Дополнительный)	Географический экстент слоя для конвертации. Объекты или растровые ячейки только из этого экстента будут включены в выходной KML. Текущий экстент отображения — Экстент будет основан на активной карте или сцене. Нарисовать экстент - Экстент будет основан на прямоугольнике, нарисованном на карте или в сцене. Экстент слоя — Экстент будет основан на активном слое карты. Выберите доступный слой или воспользуйтесь опцией Экстент данных во всех слоях. У каждого слоя карте есть следующие опции: Все объекты - Экстент всех объектов. Выбранные объекты - используйте экстент выбранных объектов. Отображаемые объекты - Экстент отображаемых объектов. Обзор — Экстент будет основан на наборе данных. Буфер обмена - Экстент может быть скопирован в буфер обмена и вставлен из него. Копировать экстент - Копирует координаты экстента и систему координат в буфер обмена. Вставить экстент - Вставляет экстент и систему координат из буфера обмена. Если буфер обмена не содержит систему координат, экстент будет использовать систему координат карты. Сбросить экстент — Экстент будет сброшен до значения по умолчанию. Если координаты заданы вручную, они должны быть числовыми значениями в системе координат активной карты. На карте могут использоваться единицы отображения, отличные от введенных координат. Используйте знак отрицательного значения для координат юга и запада.	Extent
Размер возвращаемого изображения (пикселы) (Дополнительный)	Размер листов для растровых слоев, если значение параметра Выходной масштаб слоя больше или равно 1. Этот параметр не влияет на слои, которые не являются растровыми.	Long
DPI выходного изображения (Дополнительный)	Разрешение устройства для выходных данных KML, если отмечен параметр Возвращает одно составное изображение. Используйте этот параметр вместе с параметром Размер возвращаемого изображения (пикселы) для управления разрешением выходного изображения. Этот параметр не пересчитывает исходные растры. У входных растров будет сделан снимок и включен в выходной KML в виде простого изображения `.png`.	Long
Зафиксировать объекты на земле (Дополнительный)	Укажите, будут ли значения z входных объектов игнорироваться и все объекты будет расположены или зафиксированы на земле. Отмечено–Значения z входных объектов будет игнорироваться и все объекты будут расположены или зафиксированы на земле. Если у входных объектов нет значений z, они всегда будут зафиксированы на земле. Используется по умолчанию. Не отмечено–Значения z векторных объектов будут поддерживаться в выходном KML. Объекты будут отрисованы в клиентах KML относительно уровня моря.	Boolean

arcpy.conversion.LayerToKML(layer, out_kmz_file, {layer_output_scale}, {is_composite}, {boundary_box_extent}, {image_size}, {dpi_of_client}, {ignore_zvalue})

Имя	Объяснение	Тип данных
layer	Векторный, растровый слой или составной слой, который будет конвертироваться в формат KML.	Feature Layer; Raster Layer; Mosaic Layer; Group Layer; Layer File
out_kmz_file	Выходной файл `.kml` или `.kmz`. На выходе может создаваться файл с расширением `.kmz` — это создаст архив или заархивированный файл, или с расширением `.kml` (файл базового формата KML). По умолчанию это выходной файл `.kmz`. Выходные файлы `.kmz` поддерживают растровые слои, символы и другие свойства слоя, вложения и другие сложные объекты. Выходные файлы `.kml` будут использовать основные символы и свойства KML.	File; Workspace; KML Layer
layer_output_scale (Дополнительный)	Масштаб выходного файла. Для растровых слоев можно использовать значение 0, чтобы создать одно выходное изображение, не разбитое на листы. Если используется значение 1 или больше, оно будет определять выходное разрешение растра. Этот параметр не влияет на слои, которые не являются растровыми.	Double
is_composite (Дополнительный)	Указывает, будут ли выходные данные единым составным изображением. Этот параметр применяется, только если вы задаете файл `.kmz` в качестве выходного KML, потому что файлы `.kml` не поддерживают наложение изображений и растров на земле. `COMPOSITE`–Выходные данные будут одним составным изображением, представляющим растровые или векторные объекты в исходном слое. Растр драпирован на поверхность как `GroundOverlay`. Выберите эту опцию, чтобы уменьшить размер выходного файла. Если отмечена эта опция, отдельные объекты и слои в файле `.kml` будут недоступны для выборки. Только выходные файлы `.kmz` поддерживают изображения. `NO_COMPOSITE`–Если входные данные содержат векторные объекты, они сохраняются в виде векторов KML.	Boolean
boundary_box_extent (Дополнительный)	Географический экстент слоя для конвертации. Объекты или растровые ячейки только из этого экстента будут включены в выходной KML. Экстент может быть задан с помощью следующих опций: `MAXOF` – Будет использоваться максимальный экстент всех входных данных. `MINOF` – Будет использоваться минимальная область, которая является общей для всех входных данных. `DISPLAY` — Экстент равен видимому отображению. Имя слоя — Будет использоваться экстент указанного слоя. `Extent` Объект — будет использоваться экстент указанного объекта. Строка координат, разделенная пробелами – Будет использоваться экстент указанной строки. Координаты выражаются в порядке x-мин, y-мин, x-макс, y-макс.	Extent
image_size (Дополнительный)	Размер листов для растровых слоев, если значение параметра `layer_output_scale` больше или равно 1. Этот параметр не влияет на слои, которые не являются растровыми.	Long
dpi_of_client (Дополнительный)	Разрешение устройства для выходных данных KML, если для параметра `is_composite` задано значение `COMPOSITE`. Используйте этот параметр с параметром `image_size`, чтобы контролировать выходное разрешение растра. Этот параметр не пересчитывает исходные растры. У входных растров будет сделан снимок и включен в выходной KML в виде простого изображения `.png`.	Long
ignore_zvalue (Дополнительный)	Укажите, будут ли значения z входных объектов игнорироваться и все объекты будет расположены или зафиксированы на земле. `CLAMPED_TO_GROUND`–Значения z входных объектов будет игнорироваться и все объекты будут расположены или зафиксированы на земле. Если у входных объектов нет значений z, они всегда будут зафиксированы на земле. Используется по умолчанию. `ABSOLUTE`–Значения z векторных объектов будут поддерживаться в выходном KML. Объекты будут отрисованы в клиентах KML относительно уровня моря.	Boolean

Пример кода

LayerToKML, пример 1 (окно Python)

В следующем скрипте окна Python показано, как используется функция LayerToKML в режиме прямого запуска.

import arcpy
arcpy.conversion.LayerToKML("buildings", "c:/outputKMZs/bldg.kmz")

LayerToKML, пример 2 (автономный скрипт)

В следующем скрипте Python показано, как используется функция LayerToKML в автономном скрипте.

# Description: The following stand-alone script demonstrates how to find
#              all layer files in a given workspace and export each to
#              a KML at the 1:10,000, 1:20,000, and 1:30,000 scale using
#              the LayerToKML tool.
import arcpy

arcpy.env.workspace = "C:/data"

# Set Local Variables
composite = 'NO_COMPOSITE'
pixels = 2048
dpi = 96
clamped = 'CLAMPED_TO_GROUND'

# Use the ListFiles method to identify all lyr and lyrx files in workspace
layers = arcpy.ListFiles("*.lyr*")

if len(layers) > 0:
    for layer in layers:
        # Strips the '.lyr(x)' part of the name and appends '.kmz'
        outKML = os.path.join(os.path.splitext(layer), ".kmz")
        for scale in range(10000, 30001, 10000):
            # Run LayerToKML
            arcpy.conversion.LayerToKML(layer, outKML, scale, composite,
                                        '', pixels, dpi, clamped)
else:
    arcpy.AddMessage('There are no layer files in {}'.format(arcpy.env.workspace))

Параметры среды

Текущая рабочая область, Экстент, Временная рабочая область, Поддержка вложений, Географические преобразования, Перенос описаний доменов полей

Информация о лицензировании