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

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

Конвертирует файл .kml или .kmz в наборы данных базы геоданных и файл слоя. Файл слоя поддерживает символы входных файлов .kml или .kmz.

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

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

• Выходные наборы данных будут названы Points, Lines, Polygons или Multipatches, в зависимости от типов объектов во входном файле.

  Каждый созданный класс объектов будет иметь атрибуты, содержащие информацию о входном файле. Атрибуты каждого объекта состоят из следующих элементов: структура и имя исходной папки, всплывающая информация, а также поля, которые позволяют определить, как объекты размещаются на поверхности.

• В целевой папке будет создан выходной слой, поддерживающий исходные символы KML.

• Растры или покрытие снимками будут конвертированы в набор данных мозаики в выходной базе геоданных. Исходный растр в исходном формате будет скопирован в папку GroundOverlays в целевой папке. Покрытие снимками по умолчанию не конвертируется. Используйте параметр Включить покрытие снимками, чтобы создать растры.

  Лицензия:

  Использование параметра Включить покрытие снимками, чтобы создать набор данных мозаики, требует лицензии Desktop Standard.

  Примечание:

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

• Выходные наборы данных будут создаваться в системе координат WGS84. Классы объектов могут быть перепроецированы в другую систему координат с помощью инструмента Проецировать.

• Наиболее органично поддерживается ввод в KMZ версии 2.2 стандарта OGC KML. Положения точек, использующие тег адреса (путем геокодирования), не поддерживаются. В исходном KML-файле требуются действительные координаты широты и долготы местоположения.

• ArcGIS Pro поддерживает добавление слоев KML и KMZ на карту в их исходных форматах без конвертации. Однако для редактирования или изменения слоев любым способом слой необходимо конвертировать при помощи данного инструмента. Можно выбрать слой KML в качестве входных данных этого инструмента.

Параметры

Диалог

Подпись	Описание	Тип данных
Входной файл (KML или KMZ)	Файл .kml или .kmz, который будет конвертирован в набор данных базы геоданных.	File; KML Layer
Целевая папка	Целевая папка, где будут созданы выходная база геоданных и файл слоя (.lyrx).	Folder
Выходное имя (Дополнительный)	Имя, которое будет использоваться и для выходной базы геоданных, и для файла слоя (.lyrx). По умолчанию используется имя входного файла KML. Вы можете указать имя существующей базы геоданных в целевой папке, и при конвертации новые наборы данных будут записаны в существующую базу геоданных. Если базы геоданных с указанным именем не существует, она будет создана в целевой папке.	String
Включить покрытие снимками (Дополнительный)	Указывает, будет ли покрытие снимками из KML включено в выходные данные. Используйте с осторожностью, если KMZ ссылается на сервис, предоставляющий снимки. Инструмент попытается конвертировать растровые изображения во всех доступных масштабах. Этот процесс может быть длительным и, возможно, привести к перегрузке сервера или тайм-ауту. Отмечено – покрытие снимками включается в выходные данные. Не отмечено – покрытие снимками не включается в выходные данные. Это значение по умолчанию	Boolean
Выходной суффикс (Дополнительный)	Суффикс, который будет добавлен к имени все выходных наборов классов объектов, классов объектов, наборов данных мозаики и файлов слоев. Если суффикс не указан, набор классов объектов в выходной базе геоданных будет Placemarks.	String

Производные выходные данные

Подпись	Описание	Тип данных
Выходной файл слоя	Выходной файл слоя.	Group Layer
Выходная база геоданных	Выходная база геоданных, содержащая классы объектов в наборе классов объектов, и набор данных мозаики, если включается покрытие снимками.	Workspace

Python

arcpy.conversion.KMLToLayer(in_kml_file, output_folder, {output_data}, {include_groundoverlay}, {out_suffix})

Имя	Описание	Тип данных
in_kml_file	Файл .kml или .kmz, который будет конвертирован в набор данных базы геоданных.	File; KML Layer
output_folder	Целевая папка, где будут созданы выходная база геоданных и файл слоя (.lyrx).	Folder
output_data (Дополнительный)	Имя, которое будет использоваться и для выходной базы геоданных, и для файла слоя (.lyrx). По умолчанию используется имя входного файла KML. Вы можете указать имя существующей базы геоданных в целевой папке, и при конвертации новые наборы данных будут записаны в существующую базу геоданных. Если базы геоданных с указанным именем не существует, она будет создана в целевой папке.	String
include_groundoverlay (Дополнительный)	Указывает, будет ли покрытие снимками из KML включено в выходные данные. Используйте с осторожностью, если KMZ ссылается на сервис, предоставляющий снимки. Инструмент попытается конвертировать растровые изображения во всех доступных масштабах. Этот процесс может быть длительным и, возможно, привести к перегрузке сервера или тайм-ауту. GROUNDOVERLAY—Покрытие снимками включается в выходные данные. NO_GROUNDOVERLAY—Покрытие снимками не включается в выходные данные. Это значение по умолчанию	Boolean
out_suffix (Дополнительный)	Суффикс, который будет добавлен к имени все выходных наборов классов объектов, классов объектов, наборов данных мозаики и файлов слоев. Если суффикс не указан, набор классов объектов в выходной базе геоданных будет Placemarks.	String

Производные выходные данные

Имя	Описание	Тип данных
output_layer	Выходной файл слоя.	Group Layer
out_geodatabase	Выходная база геоданных, содержащая классы объектов в наборе классов объектов, и набор данных мозаики, если включается покрытие снимками.	Workspace

Пример кода

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

Конвертирует файл .kmz в базу геоданных из окна Python.

import arcpy

arcpy.KMLToLayer_conversion(r'C:\kmls\earthquakes.kml',r'C:\gisdata\fromkmls','earthquake_09')

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

Следующий скрипт конвертирует папку с файлами .kmz или .kml в соответствующую файловую базу геоданных. Классы объектов в этих файловых базах геоданных далее будут объединены в единую файловую базу геоданных.

Примечание:

Этот скрипт не поддерживает файлы слоев, созданные функцией KMLToLayer.

# Name: BatchKML_to_GDB.py
# Description: Convert a directory of KMLs and copy the output into a single 
#              fGDB. A 2-step process: first convert the KML files; then 
#              copy the feature classes.

# Import system modules
import arcpy
import os

# Set workspace (where all the KMLs are)
arcpy.env.workspace = "C:/VancouverData/KML"

# Set local variables and location for the consolidated file geodatabase
out_location = "C:/WorkingData/fGDBs"
gdb = 'AllKMLLayers.gdb'
gdb_location = os.path.join(out_location, gdb)

# Create the primary file geodatabase
arcpy.management.CreateFileGDB(out_location, gdb)

# Convert all KMZ and KML files found in the current workspace
for kmz in arcpy.ListFiles('*.KM*'):
    print("CONVERTING: {0}".format(os.path.join(arcpy.env.workspace, kmz)))
    arcpy.conversion.KMLToLayer(kmz, out_location)

# Change the workspace to fGDB location
arcpy.env.workspace = out_location

# Loop through all the file geodatabases in the workspace
wks = arcpy.ListWorkspaces('*', 'FileGDB')
# Skip the primary GDB
wks.remove(gdb_location)

for fgdb in wks:
    # Change the workspace to the current file geodatabase
    arcpy.env.workspace = fgdb

    # For every feature class inside, copy it to the primary and use the name 
    # from the original fGDB  
    feature_classes = arcpy.ListFeatureClasses('*', '', 'Placemarks')
    for fc in feature_classes:
        print("COPYING: {} FROM: {}".format(fc, fgdb))
        fcCopy = os.path.join(fgdb, 'Placemarks', fc)
        arcpy.conversion.FeatureClassToFeatureClass(
            fcCopy, gdb_location, fgdb[fgdb.rfind(os.sep) + 1:-4])

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

Следующий скрипт конвертирует файл .kmz и извлекает данные всплывающего окна в формате HTML в атрибутивное поле.

Примечание:

Этот скрипт не поддерживает файлы слоев, созданные функцией KMLToLayer.

# Name: Extract_KML_popup_table.py
# Description: Convert a .kmz file and transfer a 2-column table from the pop-up 
#              to the field attributes.

# Import system modules
import arcpy
import os

# Set local variables and location for the consolidated file geodatabase
out_location = "C:/WorkingData/fGDBs"
gdb = 'SCP BoardDistricts.gdb'
gdb_location = os.path.join(out_location, gdb)

# Set kmz path
kmz = os.path.join(out_location, "SCP BoardDistricts.kmz")

# Convert all KMZ files to feature in the current workspace
arcpy.conversion.KMLToLayer(kmz, out_location)
    
# Change the workspace to fGDB location
arcpy.env.workspace = gdb_location

# Loop through all the file geodatabases in the workspace
feature_classes = arcpy.ListFeatureClasses('*', '', 'Placemarks')
for fc in feature_classes:
    popup_info_field_name = 'PopupInfo'
    field_names = [['gs_guid', 'TEXT', '#', 255, None, ''], 
                   ['gs_vc_revision', 'TEXT', '#', 255, None, ''], 
                   ['gs_vc_modified_sw', 'TEXT', '#', 255, None, ''], 
                   ['gs_old_objectid', 'TEXT', '#', 255, None, ''], 
                   ['gs_date_created', 'TEXT', '#', 255, None, ''], 
                   ['gs_date_modified', 'TEXT', '#', 255, None, ''], 
                   ['gs_code', 'TEXT', '#', 255, None, ''], 
                   ['gs_reference_scale', 'TEXT', '#', 255, None, ''], 
                   ['gs_description', 'TEXT', '#', 255, None, ''], 
                   ['gs_plot_scale', 'TEXT', '#', 255, None, ''], 
                   ['gs_nisc_guid', 'TEXT', '#', 255, None, ''], 
                   ['gs_mapped_by', 'TEXT', '#', 255, None, ''], 
                   ['gs_district', 'TEXT', 'Name', 255, None, ''], 
                   ['gs_boardmember', 'TEXT', '#', 255, None, ''], 
                   ['gs_servicetype', 'TEXT', 'Name', 255, None, ''], 
                   ['gs_legacy_futuraguid', 'TEXT', '#', 255, None, ''], 
                   ['gs_last_modified_by', 'TEXT', '#', 255, None, ''], 
                   ['gs_shape_from_gps_sw', 'TEXT', '#', 255, None, ''], 
                   ['gs_district_code', 'TEXT', '#', 255, None, ''], 
                   ['gs_district_name', 'TEXT', '#', 255, None, '']]
    arcpy.management.AddFields(fc, field_names, None)
    field_calculation = [[calc[0], f"extract_field(!{popup_info_field_name}!, '{calc[0]}')"] for calc in field_names]
    arcpy.management.CalculateFields(
        fc, "PYTHON3", field_calculation, 
"""from lxml import etree as _etree
def extract_field(s, field):
    ''' Extract fields from pop-up from each record in the calculate fields tool '''
    html = _etree.HTML(s)

    # Get all 'td'
    rows = html.xpath('//table/tr/td')
    next_value = False
    for row in rows:
        c = row.text
        if next_value:
            return c
        if c == field:
            next_value = True
    return None""", 
        "NO_ENFORCE_DOMAINS")

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

Текущая рабочая область, Временная рабочая область, Выходные данные имеют Z-значения

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

• Basic: Ограниченные
• Standard: Да
• Advanced: Да