Zusammenfassung
Dieses Werkzeug wandelt ein Feature oder einen Raster-Layer in eine KML-Datei (Keyhole Markup Language) um, die eine Übersetzung der Esri Geometrien und -Symbologie enthält. Diese Datei wird mit der ZIP-Komprimierung komprimiert, verfügt über die Erweiterung .kmz und kann von einem KML-Client, wie ArcGIS Explorer, ArcGlobe oder Google Earth, gelesen werden.
Verwendung
Es gibt zwei Möglichkeiten zum Steuern der Darstellung von KML-Daten.
- Wenn Layer-Eigenschaften wie die Einstellung HTML-Pop-up, Anzeigeausdrücke und der Alias für KMLSnippet enthalten sind, werden sie für die Erstellung von KML-Daten verwendet.
- Wenn die Layer-Eigenschaften nicht eingestellt sind und die Feature-Class bestimmte Attribute (Felder) enthält, werden die Feldeigenschaften für die Erstellung von KML-Daten verwendet. Layer, die ursprünglich mit dem Werkzeug KML in Layer erstellt wurden, verfügen über Attribute, anhand derer definiert wird, wie KML-Daten erstellt werden.
Weitere Informationen zum Erstellen von KML-Daten in ArcGIS for Desktop
-
Sie können die Größe des KMZ-Ausgabedokuments reduzieren, wenn der Layer über maßstabsabhängige Anzeigeeigenschaften verfügt und Sie einen geeigneten Maßstab für die Kartenausgabe wählen.
Alle KML-/KMZ-Dateien werden im WGS84-Koordinatensystem erstellt. Sie müssen sich darauf verlassen können, dass die Layer richtig abgebildet werden, wenn sie sich noch nicht in WGS84 befinden. Sie können das Werkzeug Projizieren verwenden, um die Daten vor KML-Konvertierung neu zu projizieren, wenn für die Projektion eine Transformation erforderlich ist.
Wenn Sie ein einzelnes Raster-Bild ausgeben möchten, das über eine Topographie gelegt wird, verwenden Sie die Option Einzelnes zusammengesetztes Bild zurückgeben.
Syntax
LayerToKML_conversion (layer, out_kmz_file, {layer_output_scale}, {is_composite}, {boundary_box_extent}, {image_size}, {dpi_of_client}, {ignore_zvalue})| Parameter | Erläuterung | Datentyp |
layer | Das Feature oder der Raster-Layer oder die Layer-Datei (.lyr), die in KML konvertiert werden soll. | Layer |
out_kmz_file | Die KML-Datei, in die geschrieben wird. Diese Datei wird komprimiert und verfügt über die Erweiterung .kmz. Sie kann von einem KML-Client, wie ArcGIS Explorer, ArcGlobe oder Google Earth, gelesen werden. | File |
layer_output_scale (optional) | Der Maßstab, mit dem der Layer exportiert wird. Dieser Parameter wird mit jeder Maßstabsabhängigkeit verwendet, z. B. Layer-Sichtbarkeit oder maßstabsabhängiges Rendering. Wenn ein Layer nicht im Exportmaßstab sichtbar ist, ist er in der erstellten KML-Datei nicht enthalten. Jeder Wert, z. B. 0, kann verwendet werden, wenn es keine Maßstabsabhängigkeiten gibt. Wenn Sie einen Layer exportieren, der als 3D-Vektoren angezeigt werden soll, und der Parameter is_composite auf NO_COMPOSITE eingestellt ist, können Sie diesen Parameter auf jeden Wert setzen, sofern die Features nicht maßstabsabhängig gerendert werden müssen. Es sollten nur numerische Zeichen eingegeben werden. Geben Sie beispielsweise 20000 als Maßstab ein, nicht etwa 1:20000 oder 20.000. | Double |
is_composite (optional) |
| Boolean |
boundary_box_extent (optional) | Die geographische Ausdehnung des zu exportierenden Gebiets. Die Grenzen des Ausdehnungsrechtecks sollten als eine durch Leerzeichen getrennte Zeichenfolge in WGS84-Koordinaten angegeben werden, das geographische Koordinaten nach dem Schema links unten rechts oben (xmin, ymin, xmax, ymax) beschreibt. | Extent |
image_size (optional) | Definiert die vertikale und horizontale Auflösung eines beliebigen Rasters im KML-Ausgabedokument. Verwenden Sie diesen Parameter mit dem DPI-Parameter, um die Auflösung des Ausgabebildes zu steuern. | Long |
dpi_of_client (optional) | Definiert die Geräteauflösung eines beliebigen Rasters im KML-Ausgabedokument. Verwenden Sie diesen Parameter mit dem Parameter "Bildgröße", um die Auflösung des Ausgabebildes zu steuern. | Long |
ignore_zvalue (optional) |
| Boolean |
Codebeispiel
LayerToKML – Beispiel 1(Python-Fenster)
Mit dem folgenden Skript im Python-Fenster wird veranschaulicht, wie Sie die Funktion LayerToKML im unmittelbaren Modus verwenden.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.LayerToKML_conversion("bldg.lyr", "bldg.kmz")
LayerToKML – Beispiel 2 (eigenständiges Skript)
Mit dem folgenden Python-Skript wird veranschaulicht, wie Sie die Funktion LayerToKML in einem eigenständigen Skript verwenden.
# Name: LayerToKML Example
# Description: The following stand-alone script demonstrates how to find
# all layer files in a given workspace and export each to
# a KML at the 1:10,000, 1:20,000, and 1:30,000 scale using
# the LayerToKML tool.
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Use the ListFiles method to identify all layer files in workspace
if len(arcpy.ListFiles("*.lyr")) > 0:
for layer in arcpy.ListFiles("*.lyr"):
# Set Local Variables
composite = 'NO_COMPOSITE'
pixels = 2048
dpi = 96
clamped = 'CLAMPED_TO_GROUND'
for scale in range(10000, 30001, 10000):
# Strips the '.lyr' and adds scale + _.kmz
outKML = layer[:4] + str(scale) + "_.kmz"
#Execute LayerToKML
arcpy.LayerToKML_conversion(layer, outKML, scale, composite,
'', pixels, dpi, clamped)
else:
arcpy.AddMessage('There are no layer files in '+arcpy.env.workspace+'.')
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Ja
- ArcGIS for Desktop Standard: Ja
- ArcGIS for Desktop Advanced: Ja