描述
将 KML 或 KMZ 文件转换为要素类和图层文件。图层文件用于保留于原始 KML 或 KMZ 文件中找到的符号。
使用方法
该工具用于创建包含要素数据集中要素类的文件地理数据库。会将要素类名称命名为point、line、面或multipatches,具体取决于 KML 文件的原始要素。会在文件地理数据库所在的同一文件夹级别下显示一个图层文件,并可以将该图层文件添加至地图以绘制要素。此图层文件根据其点、线或面的方案绘制要素,同时保留原始 KML 符号。
所创建的每个要素类均将含有用于保留有关原始 KML 文件的信息的属性。原始文件夹结构、名称、弹出信息以及有助于定义要素在表面出现方式的字段,所有这些都组成了每个要素的属性。
栅格或地面叠加层都将转换为文件地理数据库内的栅格目录。 在与输出文件地理数据库属于相同级别的 GroundOverlays 文件夹中可以找到本机格式的源栅格。默认情况下,不会转换地面叠加层。使用包括地面叠加层选项创建栅格。
将在 WGS84 坐标系中生成输出。必要时,可使用投影工具将输出要素投影到另一个坐标系中。
主要支持 OGC KML 标准中 KMZ 2.2 版本以下的输入。不支持使用地址标签(按地理编码方式)的点位置。源 KML 内需要有效的经度和纬度位置。
语法
arcpy.conversion.KMLToLayer(in_kml_file, output_folder, {output_data}, {include_groundoverlay})
参数 | 说明 | 数据类型 |
in_kml_file | 要转换的 KML 或 KMZ 文件。 | File |
output_folder | 文件地理数据库与图层 (.lyr) 文件的目标文件夹。 | Folder |
output_data (可选) | 输出文件地理数据库和图层文件的名称。默认为输入 KML 文件的名称。 | String |
include_groundoverlay (可选) | 包括地面叠加层(栅格、航空照片等)。KMZ 指向提供栅格影像的服务时,请谨慎使用。该工具将尝试按所有可用比例转换栅格影像。此过程也许会较漫长且可能超出服务能力范围。
| Boolean |
派生输出
名称 | 说明 | 数据类型 |
output_layer | 输出图层文件。 | 图层组 |
out_geodatabase | 包含要素数据集内一个要素类的输出地理数据库。 | 工作空间 |
代码示例
KMLToLayer 示例 1(Python 窗口)
在 Python 窗口中,将 KMZ 文件转换为文件地理数据库。
import arcpy
arcpy.KMLToLayer_conversion(r'C:\kmls\earthquakes.kml',r'C:\gisdata\fromkmls','earthquake_09')
KMLToLayer 示例 2(独立脚本)
以下脚本会将 KMZ 和 KML 文件的文件夹转换为其各自的文件地理数据库。然后,会将这些文件地理数据库内的要素类合并到单个文件地理数据库中。
# Name: BatchKML_to_GDB.py
# Description: Converts a directory of KMLs and copies the output into a single
# fGDB. A 2 step process: first convert the KML files, and 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 master FileGeodatabase
arcpy.CreateFileGDB_management(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.KMLToLayer_conversion(kmz, out_location)
# Change the workspace to fGDB location
arcpy.env.workspace = out_location
# Loop through all the FileGeodatabases within the workspace
wks = arcpy.ListWorkspaces('*', 'FileGDB')
# Skip the Master GDB
wks.remove(gdb_location)
for fgdb in wks:
# Change the workspace to the current FileGeodatabase
arcpy.env.workspace = fgdb
# For every Featureclass inside, copy it to the Master 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.FeatureClassToFeatureClass_conversion(
fcCopy, gdb_location, fgdb[fgdb.rfind(os.sep) + 1:-4])
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是