Карта в KML (Конвертация)

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

Конвертирует карту в файл KML, содержащий геометрию и символы. Выходной файл сжимается с помощью ZIP-сжатия, имеет расширение .kmz и может быть прочитан любым клиентом KML, включая ArcGIS Earth и Google Earth.

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

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

  • Вы можете управлять внешним видом KML двумя способами:

    • По умолчанию всплывающее окно включает все видимые поля слоя. Отображение всплывающего окна можно задать, используя настраиваемые всплывающие окна слоя. Когда всплывающие окна не настроены, при щелчке по объекту KML во всплывающем окне отображаются значения поля PopupInfo векторного слоя. Эти значения могут быть числовыми или текстовыми атрибутами, а также HTML-кодом, хранящимся в текстовом поле.
    • Если свойства слоя не заданы и класс объектов содержит определенные атрибуты (поля), то свойства полей будут использоваться при создании слоев KML, которые были изначально созданы инструментом KML в слой, включая атрибуты, которые определяют, как именно создавать KML. См. раздел Конвертация KML для получения информации о создании KML по атрибутам.

  • Можно уменьшить размер выходного документа KMZ, если карта имеет зависящие от масштаба свойства отображения слоя, и выбран соответствующий масштаб выходных данных карты.

  • Все файлы .kml и .kmz создаются в системе координат WGS84. Убедитесь, что слои будут правильно проецироваться, если они не в WGS84. Если необходимо преобразование проекции, вы можете воспользоваться инструментом Проецировать, чтобы перепроецировать данные перед конвертацией в KML.

  • Для вывода одного растрового изображения, драпированного над топографией, используйте параметр Возвращает одно составное изображение.

  • Чтобы в выходных данных каждый слой был в виде отдельного растрового изображения, используйте параметр Конвертировать вектор в растр.

  • Параметры Выходной масштаб карты и Размер возвращаемого изображения (пикселов) используются вместе для создания листов выходных данных. Например, для изображения 7000 на 5000 пикселов и параметра Размер возвращаемого изображения (пикселы) со значением 1000 пикселов итоговое изображение будет состоять из 7 x 5 = 35 меньших изображений. Если значение параметра Выходной масштаб карты установлено равным 1, то каждый фрагмент изображения будет иметь размер 1000 на 1000 пикселов. Если значение параметра Выходной масштаб карты установлено равным 10, то каждый фрагмент изображения будет иметь размер 100 на 100 пикселов.

  • Чтобы включить легенду в выходной KML, укажите значение параметра Источник компоновки легенды. У вас должен быть элемент легенды в компоновке карты.

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

Параметры

ПодписьОписаниеТип данных
Входная карта

Карта, сцена или базовая карта для конвертирования в KML.

Map
Выходной файл

Выходной файл KML. Этот файл сжимается и имеет расширение .kmz. Файл может быть прочитан любым клиентом KML, включая ArcGIS Earth и Google Earth.

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
Экстент для экспорта
(Дополнительный)

Географический экстент области, которая будет экспортирована. Укажите прямоугольные границы экстента в виде разделенной пробелами строки географических координат WGS84 в формате: левый нижний правый верхний (x-min, y-min, x-max, y-max).

  • По умолчанию – экстент основывается на максимальном экстенте всех задействованных слоев. Это значение по умолчанию.
  • Экстент текущего отображения – экстент будет равен фрейму данных или видимому отображению. Опция недоступна, если нет активной карты.
  • Как указано ниже – экстент будет основан на указанных минимальном и максимальном значениях экстента.
  • Найти—экстент будет основан на существующем наборе данных.
Extent
Размер возвращаемого изображения (пикселы)
(Дополнительный)

Размер листов для растровых слоев, если значение параметра Выходной масштаб карты задано равным 1 или больше. Этот параметр влияет только на растровые слои.

Long
DPI выходного изображения
(Дополнительный)

Разрешение устройства для любых растров в выходном документе KML. Обычное разрешение экрана – 96 dpi. Если данные в карте поддерживают высокое разрешение, и для KML оно необходимо, рассмотрите возможность увеличения этого значения. Использование этого параметра вместе с параметром Размер возвращаемого изображения (пикселы) для управления разрешением выходного изображения. Значение, предлагаемое по умолчанию, равно 96.

Long
Зафиксировать объекты на земле
(Дополнительный)

Указывает, будут ли объекты зафиксированы на земле.

  • Отмечено — z-значения входных объектов будут игнорироваться, а выходные данные KML будут созданы с объектами, зафиксированными на земле. Объекты будут драпированы на поверхность. Используйте эту опцию, когда объекты не имеют 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. Файл может быть прочитан любым клиентом KML, включая ArcGIS Earth и Google Earth.

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

Географический экстент области, которая будет экспортирована. Укажите прямоугольные границы экстента в виде разделенной пробелами строки географических координат WGS84 в формате: левый нижний правый верхний (x-min, y-min, x-max, y-max).

  • MAXOF - будет использоваться максимальный экстент всех входных данных.
  • MINOF - будет использоваться минимальная область, общая для всех входных данных.
  • DISPLAY– экстент будет равен видимому отображению.
  • Имя слоя - будет использоваться тот же экстент, что и в указанном слое.
  • Объект Extent - будет использоваться тот же экстент, что и в указанном объекте.
  • Строка координат, разделенных пробелами – будет использоваться экстент из заданной строки. Координаты должны быть выражены в таком порядке: x-min, y-min, x-max, y-max.
Extent
image_size
(Дополнительный)

Размер листов для растровых слоев, если значение параметра map_output_scale задано равным 1 или больше. Этот параметр влияет только на растровые слои.

Long
dpi_of_client
(Дополнительный)

Разрешение устройства для любых растров в выходном документе KML. Обычное разрешение экрана – 96 dpi. Если данные в карте поддерживают высокое разрешение, и для KML оно необходимо, рассмотрите возможность увеличения этого значения. Используйте этот параметр с параметром image_size, чтобы контролировать выходное разрешение растра. Значение, предлагаемое по умолчанию, равно 96.

Long
ignore_zvalue
(Дополнительный)

Указывает, будут ли объекты зафиксированы на земле.

  • CLAMPED_TO_GROUNDZ-значения входных объектов будут игнорироваться, а выходные данные KML будут созданы с объектами, зафиксированными на земле. Объекты будут драпированы на поверхность. Используйте эту опцию, когда объекты не имеют z-значений. Это значение по умолчанию
  • ABSOLUTEПри создании KML используются z-значения объектов. В клиентах KML объекты будут отображаться относительно уровня моря.
Boolean
layout
(Дополнительный)

Имя компоновки, содержащей элементы легенды, которые будут включены в выходной KML в качестве экранных наложений.

String

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.MapToKML("cities.mapx", "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))

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

Этот инструмент не использует параметры среды геообработки

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

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы