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

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

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

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

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

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

Только элементы легенды преобразуются в наложения на экране в KML. Каждая легенда становится вложенной папкой в основной папке KML при просмотре данных KML.

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

arcpy.conversion.MapToKML(in_map, out_kmz_file, {map_output_scale}, {is_composite}, {is_vector_to_raster}, {extent_to_export}, {image_size}, {dpi_of_client}, {ignore_zvalue}, {layout})

Имя	Объяснение	Тип данных
in_map	Карта, сцена или базовая карта, которые будут конвертированы в KML.	Map
out_kmz_file	Выходной файл KML, который будет сжат и храниться с расширением `.kmz`.	File
map_output_scale (Дополнительный)	Масштаб, в котором будет экспортирован каждый слой карты. Этот параметр используется с любыми видами масштабной зависимости, такими как видимость слоя или масштабозависимое отображение. Если слой не виден в выходном масштабе, он не включается в выходной KML. Если масштабной зависимости нет, можно использовать любое значение, например, 1. Для растровых слоев можно использовать значение 0, чтобы создать одно выходное изображение, не разбитое на листы. Если используется значение, большее или равное 1, то оно определяет выходное разрешение растра. Этот параметр не влияет на слои, которые не являются растровыми. Принимаются только числовые символы; например, введите 20000 в качестве масштаба, а не 1:20000. В языках, использующих запятую в качестве разделителя десятичных значений, также можно использовать 20,000. Если вы экспортируете слой, который должен отображаться в виде 3D-векторов, и параметр `is_composite` задан как `NO_COMPOSITE`, вы можете задать этому параметру любое значение, при условии, что объекты не имеют масштабозависимого отображения.	Double
is_composite (Дополнительный)	Указывает, будут ли выходные данные KML содержать единое составное изображение или отдельные слои. `COMPOSITE`–Выходной KML-файл будет содержать единое изображение, объединяющее все объекты карты в одно растровое изображение. Растр драпирован на поверхность как KML `GroundOverlay`. Эта опция уменьшает размер выходного файла KML. Отдельные объекты и слои в KML будут недоступны для выборки. `NO_COMPOSITE`–Выходной файл KML будет содержать отдельные слои. Используется по умолчанию. Возвращаются ли слои как растры или как комбинация векторов и растров, определяется значением параметра `is_vector_to_raster`.	Boolean
is_vector_to_raster (Дополнительный)	Определяет, будет ли каждый векторный слой на карте преобразован в отдельное растровое изображение или сохранен как векторные объекты. Этот параметр не используется, если для параметра `is_composite` задано `COMPOSITE`. `VECTOR_TO_IMAGE`–Векторные слои конвертируются в отдельное растровое изображение в выходном KML. Нормальные растровые слои также добавляются к выходным данным KML. Каждый выходной растровый слой KML доступен для выборки и его прозрачности можно регулировать в конкретных приложениях просмотра KML. `VECTOR_TO_VECTOR`–Векторные объекты будут сохраняться в выходном KML как векторные геометрии. Используется по умолчанию.	Boolean
extent_to_export (Дополнительный)	Географический экстент слоя для конвертации. Объекты или растровые ячейки только из этого экстента будут включены в выходной KML. Экстент может быть задан с помощью следующих опций: `MAXOF` – Будет использоваться максимальный экстент всех входных данных. `MINOF` – Будет использоваться минимальная область, которая является общей для всех входных данных. `DISPLAY` — Экстент равен видимому отображению. Имя слоя — Будет использоваться экстент указанного слоя. `Extent` Объект — будет использоваться экстент указанного объекта. Строка координат, разделенная пробелами – Будет использоваться экстент указанной строки. Координаты выражаются в порядке x-мин, y-мин, x-макс, y-макс.	Extent
image_size (Дополнительный)	Размер листов для растровых слоев, если значение параметра `map_output_scale` больше или равно 1. Этот параметр не влияет на слои, которые не являются растровыми.	Long
dpi_of_client (Дополнительный)	Разрешение устройства для любых растров в выходном документе KML. Обычное разрешение экрана – 96 dpi. Если данные на карте поддерживают высокое разрешение и этого требует KML, подумайте об увеличении этого значения. Используйте этот параметр с параметром `image_size`, чтобы контролировать выходное разрешение растра. Значение, предлагаемое по умолчанию, равно 96.	Long
ignore_zvalue (Дополнительный)	Укажите, будут ли значения z входных объектов игнорироваться и все объекты будет расположены или зафиксированы на земле. `CLAMPED_TO_GROUND`–Значения z входных объектов будет игнорироваться и все объекты будут расположены или зафиксированы на земле. Если у входных объектов нет значений z, они всегда будут зафиксированы на земле. Используется по умолчанию. `ABSOLUTE`–Значения z векторных объектов будут поддерживаться в выходном KML. Объекты будут отрисованы в клиентах KML относительно уровня моря.	Boolean
layout (Дополнительный)	Имя компоновки, которая содержит элементы легенды для включения в выходной KML как наложения на экране.	String

Пример кода

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

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

import arcpy
arcpy.conversion.MapToKML("C:/Maps/Cities.mapx", "C:/OutputMaps/Cities.kmz")

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

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

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Use ListFiles to identify all map files in workspace
files = arcpy.ListFiles('*.mapx')
if len(files) > 0:
    for map_file in files:
        # Set Local Variables
        composite = 'NO_COMPOSITE'
        vector = 'VECTOR_TO_VECTOR'
        pixels = 2048
        dpi = 96
        clamped = 'ABSOLUTE'
        for scale in range(10000, 20000, 30000):
            # Strips the '.mapx' part of the name and appends '.kmz'
            outKML = map_file[:-5]+'.kmz'

            # Run MapToKML
            arcpy.conversion.MapToKML(map_file, outKML, scale, composite,
                                      vector, '', pixels, dpi, clamped)
else:
    arcpy.AddMessage('There are no map files (*.mapx) in {}.'.format(arcpy.env.workspace))

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

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

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