Zusammenfassung
Konvertiert eine KML- oder KMZ-Datei in Feature-Classes und eine Layer-Datei. Die Layer-Datei übernimmt die Symbolisierung aus der ursprünglichen KML- oder KMZ-Datei.
Verwendung
Dieses Werkzeug erstellt eine File-Geodatabase, die eine Feature-Class innerhalb eines Feature-Datasets enthält. Der Name der Feature-Class lautet point, line, polygon oder multipatches, je nach den ursprünglichen Features der KML-Datei. Auf der gleichen Ordnerebene wie die File-Geodatabase befindet sich eine Layer-Datei, die zu einer Karte hinzugefügt werden kann, um die Features zu zeichnen. Diese Layer-Datei zeichnet Features basierend auf ihrem Schema (Punkt, Linie oder Polygon), wobei die ursprüngliche KML-Symbolisierung beibehalten wird.
Jede erstellte Feature-Class weist Attribute auf, die Informationen zur ursprünglichen KML-Datei enthalten. Die ursprüngliche Ordnerstruktur, Name und Pop-up-Informationen sowie Felder, die definieren, wie sich Features auf einer Oberfläche befinden, bilden die Attribute eines Features.
Raster oder Boden-Overlays werden in der File-Geodatabase in einen Raster-Katalog konvertiert. Das Quell-Raster in seinem systemeigenen Format ist im Ordner GroundOverlays auf derselben Ebene wie die Ausgabe-File-Geodatabase verfügbar. Boden-Overlays werden nicht standardmäßig konvertiert. Verwenden Sie die Option Bodenüberlagerung einbeziehen, um Raster zu erstellen.
Die Ausgabe wird im WGS84-Koordinatensystem generiert. Falls gewünscht, können die Ausgabe-Features mit dem Werkzeug Projizieren in ein anderes Koordinatensystem neu projiziert werden.
Eingaben bis zu KMZ-Version 2.2 des OGC KML-Standards werden weitgehend unterstützt. Punktpositionen, die den Adress-Tag verwenden (durch Geokodierung), werden nicht unterstützt. Im Quell-KML ist eine gültige Längen- und Breitengradposition erforderlich.
Syntax
KMLToLayer(in_kml_file, output_folder, {output_data}, {include_groundoverlay})
Parameter | Erklärung | Datentyp |
in_kml_file | Die zu übertragende KML- oder KMZ-Datei. | File |
output_folder | Der Zielordner für die File-Geodatabase und die Layer-Datei (.lyr). | Folder |
output_data (optional) | Der Name der Ausgabe-File-Geodatabase und der Layer-Datei. Standardmäßig wird der Name der Eingabe-KML-Datei verwendet. | String |
include_groundoverlay (optional) | Beziehen Sie Boden-Overlays (Raster, Luftaufnahmen usw.) ein. Seien Sie vorsichtig, wenn die KMZ-Datei auf einen Service verweist, der Raster-Bilddaten bereitstellt. Das Werkzeug versucht, die Raster-Bilddaten in allen verfügbaren Maßstäben zu übertragen. Dieser Prozess kann lange dauern und den Service möglicherweise überlasten.
| Boolean |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
output_layer | Die Ausgabe-Layer-Datei. | Gruppen-Layer |
out_geodatabase | Die Ausgabe-Geodatabase, die eine Feature-Class innerhalb eines Feature-Datasets enthält. | Workspace |
Codebeispiel
KMLToLayer – Beispiel 1 (Python-Fenster)
Konvertiert eine KMZ-Datei in eine File-Geodatabase über das Python-Fenster.
import arcpy
arcpy.KMLToLayer_conversion(r'C:\kmls\earthquakes.kml',r'C:\gisdata\fromkmls','earthquake_09')
KMLToLayer - Beispiel 2 (eigenständiges Skript)
Mit dem folgenden Skript wird ein Ordner mit KMZ- und KML-Dateien in die entsprechende File-Geodatabase konvertiert. Die Feature-Classes in diesen File-Geodatabases werden dann zu einer einzigen File-Geodatabase konsolidiert.
# 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])
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja