Layer in KML (Konvertierung)

Lizenzstufe:BasicStandardAdvanced

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.

Weitere Informationen zur KML-Unterstützung in ArcGIS

Verwendung

Syntax

LayerToKML_conversion (layer, out_kmz_file, {layer_output_scale}, {is_composite}, {boundary_box_extent}, {image_size}, {dpi_of_client}, {ignore_zvalue})
ParameterErläuterungDatentyp
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, solange 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)
  • COMPOSITEDie ausgegebene KML-Datei ist ein einzelnes zusammengesetztes Bild, das das Raster- oder die Vektor-Features im Quell-Layer darstellt. Das Raster wird als KML-GroundOverlay über ein Terrain gelegt. Wählen Sie diese Option, wenn Sie die Größe der KMZ-Ausgabedatei reduzieren möchten. Wenn Sie dieses Feld aktivieren, sind einzelne Features und Layer im KML nicht wählbar.
  • NO_COMPOSITEWenn der Layer über Vektor-Features verfügt, werden diese als KML-Vektoren beibehalten. (Wenn der Layer ein Raster ist, können Sie eine der beiden Option für diesen Parameter auswählen, wobei im Ergebnis kein Unterschied sichtbar ist.)
Boolean
boundary_box_extent
(optional)

Die geographische Ausdehnung des zu exportierenden Gebiets. Die Grenzen des Ausdehnungsrechtecks sollten als eine durch Leerzeichen getrennte Zeichenfolge des WGS84 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)
  • ABSOLUTEVerwenden Sie die Z-Werte von Features, wenn Sie KML-Daten erstellen. Die Features werden in KML-Clients im Verhältnis zum Meeresspiegel dargestellt.
  • CLAMPED_TO_GROUNDÜberschreiben Sie die Z-Werte in den Features und erstellen Sie KML-Daten mit bodenverbundenen Features. Die Features werden über ein Terrain gelegt. Diese Einstellung wird für Features verwendet, die keine Z-Werte aufweisen. Dies ist die Standardeinstellung.
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.
# Author: ESRI

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'
        # Strips the '.lyr' part of the name and appends '.kmz'
        outKML = file[:4] + ".kmz"
        for scale in range(10000, 30001, 10000):
            #Execute LayerToKML
            arcpy.LayerToKML_conversion(layer, outKML, scale, composite, 
                                        '', pixels, dpi, clamped)
else:
    arcpy.AddMessage('There are no layer files in '+env.workspace+'.')

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Ja
ArcGIS for Desktop Standard: Ja
ArcGIS for Desktop Advanced: Ja
9/11/2013