Layer in KML (Conversion Tools)

Zusammenfassung

Konvertiert ein Feature- oder Raster-Layer in das KML-Format (.kmz- oder .kml-Datei). Die KML-Ausgabedatei enthält eine Übersetzung der Esri Feature-Geometrien, Rasterzellen, Layer-Symbolisierung und anderer Eigenschaften.

Weitere Informationen zur KML-Unterstützung in ArcGIS

Verwendung

Die Standardausgabe des Werkzeugs hat die Erweiterung .kmz und ist ein Archiv oder eine .zip-Datei, die eine .kml-Datei und andere ergänzende Dateien enthält. Eine .kmz-Datei kann von vielen Anwendungen gelesen werden, darunter ArcGIS Earth und Google Earth.
Sie können das Aussehen von KML auf folgende zwei Arten steuern:
- Die Pop-up-Anzeige setzt sich standardmäßig aus allen sichtbaren Feldern aus dem Layer zusammen. Pop-up-Anzeigen können auch über benutzerdefinierte Popu-ps des Layers festgelegt werden. Wenn die Layer-Pop-ups nicht angepasst wurden, werden die Werte im Feld PopupInfo des Feature-Layers im Pop-up angezeigt, wenn auf ein KML-Feature geklickt wird. Bei diesen Werten kann es sich um Zahlen oder Textattribute oder auch HTML-Code handeln, der in einem Textfeld gespeichert ist.
- Wenn die Layer-Eigenschaften nicht festgelegt sind und die Feature-Class bestimmte Attribute (Felder) enthält, werden bei der Erstellung der KML-Layer, die ursprünglich mit dem Werkzeug KML in Layer erstellt wurden, die Feldeigenschaften verwendet, einschließlich der Attribute, die festlegen, wie die KML-Datei erstellt wurde. Weitere Informationen zur Erstellung von KML-Dateien aus Attributen finden Sie unter "KML-Konvertierung".
Wenn die Eingabe maßstabsabhängige Anzeigeeigenschaften aufweist, können Sie die Größe der .kmz-Ausgabedatei reduzieren, indem Sie einen entsprechenden Wert für den Parameter Maßstab für Layer-Ausgabe angeben.
Die Eingabe-Layer wird in das Koordinatensystem WGS84 projiziert, da dieses von allen .kml- und .kmz-Dateien verwendet werden muss. Um sicherzustellen, dass die Features und Raster-Zellen in der Projektion präzise verortet werden, müssen Sie möglicherweise die Umgebungseinstellung "Geographische Transformation" vewenden. Sie können die Eingabe-Layer auch mit dem Werkzeug Projizieren mit einer gültigen Transformation erneut in das Koordinatensystem WGS84 projizieren, bevor Sie sie in KML konvertieren.
Eingabe-Features mit Anlagen werden in die .kmz-Ausgabedatei einbezogen. Beachten Sie die folgenden Bedingungen für Anlagen in .kmz-Dateien.
- Anlagen können die Ausgabedatei erheblich vergrößern.
- Bei Verwendung der .kml-Datei in einem KML-Client werden Anlagen über das KML-Pop-up zur Verfügung gestellt.
- Anlagen können ausgeschlossen werden, indem die Umgebungseinstellung "Anlagen beibehalten" vor Ausführung des Werkzeugs deaktiviert wird.
- Die Anzeige von Anlagen wird nicht von allen KML-Clients gleichermaßen unterstützt. Einige KML-Client-Anwendungen bieten eine bessere Unterstützung für Anlagen wie Bilder und PDFs.
Anlagen werden nicht einbezogen, wenn es sich um eine .kml-Ausgabedatei handelt.
Die Parameter Maßstab für Layer-Ausgabe und Größe des zurückgegebenen Bildes (Pixel) werden gemeinsam verwendet, um eine gekachelte Ausgabe zu erstellen. Bei einem Bild mit einer Größe von 7.000 x 5.000 Pixeln und einem Wert von 1.000 Pixeln für den Parameter Größe des zurückgegebenen Bildes (Pixel) etwa besteht das Ausgabebild aus 7 x 5 bzw. 35 Sub-Bildern. Wenn für den Parameter Maßstab für Layer-Ausgabe der Wert 1 festgelegt wird, enthält jedes Sub-Bild 1000 x 1000 Pixel. Wenn für den Parameter Maßstab für Layer-Ausgabe der Wert 10 festgelegt wird, enthält jedes Sub-Bild 100 x 100 Pixel.
Domänenbeschreibungen werden in die Ausgabe übertragen, wenn die Umgebungseinstellung "Felddomänen-Beschreibungen übertragen" aktiviert ist.

Beschriftung	Erläuterung	Datentyp
Eingabe-Layer	Der Feature- oder Raster-Layer oder der Gruppen-Layer, der in das KML-Format konvertiert wird.	Feature Layer; Raster Layer; Mosaic Layer; Group Layer; Layer File
Ausgabedatei (KML oder KMZ)	Die `.kml`- oder `.kmz`-Ausgabedatei. Die Ausgabedatei kann die Erweiterung `.kmz` haben und ein Archiv oder eine gezippte Datei erzeugen oder die Erweiterung `.kml` und eine einfache Datei im KML-Format erzeugen. Standardmäßig erfolgt die Ausgabe als `.kmz`-Datei. `.kmz`-Ausgabedateien unterstützen Raster-Layer, Symbolisierungs- und andere Layer-Eigenschaften, Anhänge und sonstige erweiterte Features. In `.kml`-Ausgabedateien werden KML-Standardsymbole und -eigenschaften verwendet.	File; Workspace; KML Layer
Maßstab für Layer-Ausgabe (Optional)	Der Maßstab der Ausgabedatei. Bei Raster-Layern kann der Wert 0 angegeben werden, um ein ungekacheltes Ausgabebild zu erstellen. Wenn ein Wert größer als oder gleich 1 verwendet wird, bestimmt dieser die Ausgabeauflösung des Rasters. Dieser Parameter hat keine Auswirkungen auf Layer, die keine Raster-Layer sind.	Double
Einzelnes zusammengesetztes Bild zurückgeben (Optional)	Gibt an, ob die Ausgabe ein einzelnes zusammengesetztes Bild ist. Dieser Parameter gilt nur, wenn Sie als `.kmz`-Datei das Ausgabe-KML auswählen, da `.kml`-Dateien keine Boden-Overlay-Bilder oder -Raster unterstützen. Aktiviert—Die ausgegebene Datei ist ein einzelnes zusammengesetztes Bild, das das Raster- oder die Vektor-Features im Quell-Layer darstellt. Das Raster wird als `GroundOverlay` über ein Terrain gelegt. Verwenden Sie diese Option, wenn Sie die Größe der Ausgabedatei reduzieren möchten. Wenn diese Option verwendet wird, können keine einzelnen Features und Layer in der `.kml`-Datei ausgewählt werden. Bilder werden nur von `.kmz`-Ausgabedateien unterstützt. Deaktiviert—Wenn die Eingabe über Vektor-Features verfügt, werden diese als KML-Vektoren beibehalten.	Boolean
Ausdehnung (Optional)	Die geographische Ausdehnung des zu konvertiertenden Layers. Es werden nur Features oder Raster-Zellen in dieser Ausdehnung in die KML-Ausgabe einbezogen. Aktuelle Anzeigeausdehnung : Die Ausdehnung basiert auf der aktiven Karte oder Szene. Ausdehnung darstellen : Die Ausdehnung basiert auf einem Rechteck, das auf der Karte oder Szene aufgezogen wurde. Ausdehnung eines Layers : Die Ausdehnung basiert auf einem aktiven Karten-Layer. Wählen Sie einen verfügbaren Layer aus, oder verwenden Sie die Option Ausdehnung von Daten in allen Layern. Jeder Karten-Layer bietet die folgenden Optionen: Alle Features : Die Ausdehnung aller Features. Ausgewählte Features : Die Ausdehnung der ausgewählten Features. Sichtbare Features : Die Ausdehnung sichtbarer Features. Durchsuchen : Die Ausdehnung basiert auf einem Dataset. Zwischenablage : Die Ausdehnung kann in die und aus der Zwischenablage kopiert werden. Ausdehnung kopieren : Kopiert die Ausdehnung und das Koordinatensystem in die Zwischenablage. Ausdehnung einfügen : Fügt die Ausdehnung und das Koordinatensystem aus der Zwischenablage ein. Wenn die Zwischenablage kein Koordinatensystem enthält, wird für die Ausdehnung das Koordinatensystem der Karte verwendet. Ausdehnung zurücksetzen : Die Ausdehnung wird auf den Standardwert zurückgesetzt. Wenn die Koordinaten manuell eingegeben wurden, dann müssen die Koordinaten numerische Werte sein und im Koordinatensystem der aktiven Karte liegen. Die Karte kann statt der angegebenen Koordinaten auch andere Anzeigeeinheiten verwenden. Verwenden Sie für die Koordinaten in Richtung Süden und Westen Werte mit negativem Vorzeichen.	Extent
Größe des zurückgegebenen Bildes (Pixel) (Optional)	Die Größe der Kacheln für Raster-Layer, wenn der Wert für den Parameter Maßstab für Layer-Ausgabe größer als oder gleich 1 ist. Dieser Parameter hat keine Auswirkungen auf Layer, die keine Raster-Layer sind.	Long
DPI des Ausgabebildes (Optional)	Die Geräteauflösung für die KML-Ausgabe, wenn der Parameter Einzelnes zusammengesetztes Bild zurückgeben aktiviert wird. Verwenden Sie diesen Parameter mit dem Parameter Größe des zurückgegebenen Bildes (Pixel), um die Auflösung des Ausgabebildes zu steuern. Dieser Parameter ermöglicht kein Resampling von Quell-Rastern. Von allen Eingabe-Rastern wird ein Snapshot erstellt und als einfaches `.png`-Bild in die KML-Ausgabe eingefügt.	Long
Features am Boden befestigen (Optional)	Gibt an, ob die Z-Werte der Eingabe-Features ignoriert und alle Features auf Geländehöhe verortet bzw. befestigt werden. Aktiviert—Die Z-Werte der Eingabe-Features werden ignoriert und alle Features auf Geländehöhe verortet bzw. befestigt. Wenn die Eingabe-Features keine Z-Werte aufweisen, werden Sie immer am Boden befestigt. Dies ist die Standardeinstellung. Deaktiviert—Die Z-Werte der Features bleiben in der KML-Ausgabe erhalten. Die Features werden in KML-Clients im Verhältnis zum Meeresspiegel dargestellt.	Boolean

arcpy.conversion.LayerToKML(layer, out_kmz_file, {layer_output_scale}, {is_composite}, {boundary_box_extent}, {image_size}, {dpi_of_client}, {ignore_zvalue})

Name	Erläuterung	Datentyp
layer	Der Feature- oder Raster-Layer oder der Gruppen-Layer, der in das KML-Format konvertiert wird.	Feature Layer; Raster Layer; Mosaic Layer; Group Layer; Layer File
out_kmz_file	Die `.kml`- oder `.kmz`-Ausgabedatei. Die Ausgabedatei kann die Erweiterung `.kmz` haben und ein Archiv oder eine gezippte Datei erzeugen oder die Erweiterung `.kml` und eine einfache Datei im KML-Format erzeugen. Standardmäßig erfolgt die Ausgabe als `.kmz`-Datei. `.kmz`-Ausgabedateien unterstützen Raster-Layer, Symbolisierungs- und andere Layer-Eigenschaften, Anhänge und sonstige erweiterte Features. In `.kml`-Ausgabedateien werden KML-Standardsymbole und -eigenschaften verwendet.	File; Workspace; KML Layer
layer_output_scale (Optional)	Der Maßstab der Ausgabedatei. Bei Raster-Layern kann der Wert 0 angegeben werden, um ein ungekacheltes Ausgabebild zu erstellen. Wenn ein Wert größer als oder gleich 1 verwendet wird, bestimmt dieser die Ausgabeauflösung des Rasters. Dieser Parameter hat keine Auswirkungen auf Layer, die keine Raster-Layer sind.	Double
is_composite (Optional)	Gibt an, ob die Ausgabe ein einzelnes zusammengesetztes Bild ist. Dieser Parameter gilt nur, wenn Sie als `.kmz`-Datei das Ausgabe-KML auswählen, da `.kml`-Dateien keine Boden-Overlay-Bilder oder -Raster unterstützen. `COMPOSITE`—Die ausgegebene Datei ist ein einzelnes zusammengesetztes Bild, das das Raster- oder die Vektor-Features im Quell-Layer darstellt. Das Raster wird als `GroundOverlay` über ein Terrain gelegt. Verwenden Sie diese Option, wenn Sie die Größe der Ausgabedatei reduzieren möchten. Wenn diese Option verwendet wird, können keine einzelnen Features und Layer in der `.kml`-Datei ausgewählt werden. Bilder werden nur von `.kmz`-Ausgabedateien unterstützt. `NO_COMPOSITE`—Wenn die Eingabe über Vektor-Features verfügt, werden diese als KML-Vektoren beibehalten.	Boolean
boundary_box_extent (Optional)	Die geographische Ausdehnung des zu konvertiertenden Layers. Es werden nur Features oder Raster-Zellen in dieser Ausdehnung in die KML-Ausgabe einbezogen. Die Ausdehnung kann mit den folgenden Optionen konfiguriert werden: `MAXOF`: Die maximale Ausdehnung aller Eingaben wird verwendet. `MINOF`: Die minimale gemeinsame Fläche aller Eingaben wird verwendet. `DISPLAY`: Die Ausdehnung entspricht der sichtbaren Anzeige. Layer-Name: Die Ausdehnung des angegebenen Layers wird verwendet. `Extent` Objekt: Die Ausdehnung des angegebenen Objekts wird verwendet. Eine durch Leerzeichen getrennte Zeichenfolge von Koordinaten: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Koordinaten werden im Format X-Min, Y-Min, X-Max, Y-Max angegeben.	Extent
image_size (Optional)	Die Größe der Kacheln für Raster-Layer, wenn der Wert für den Parameter `layer_output_scale` größer als oder gleich 1 ist. Dieser Parameter hat keine Auswirkungen auf Layer, die keine Raster-Layer sind.	Long
dpi_of_client (Optional)	Die Geräteauflösung für die KML-Ausgabe, wenn der Parameter `is_composite` auf `COMPOSITE` festgelegt wurde. Verwenden Sie diesen Parameter mit dem Parameter `image_size`, um die Auflösung des Ausgabebildes zu steuern. Dieser Parameter ermöglicht kein Resampling von Quell-Rastern. Von allen Eingabe-Rastern wird ein Snapshot erstellt und als einfaches `.png`-Bild in die KML-Ausgabe eingefügt.	Long
ignore_zvalue (Optional)	Gibt an, ob die Z-Werte der Eingabe-Features ignoriert und alle Features auf Geländehöhe verortet bzw. befestigt werden. `CLAMPED_TO_GROUND`—Die Z-Werte der Eingabe-Features werden ignoriert und alle Features auf Geländehöhe verortet bzw. befestigt. Wenn die Eingabe-Features keine Z-Werte aufweisen, werden Sie immer am Boden befestigt. Dies ist die Standardeinstellung. `ABSOLUTE`—Die Z-Werte der Features bleiben in der KML-Ausgabe erhalten. Die Features werden in KML-Clients im Verhältnis zum Meeresspiegel dargestellt.	Boolean

Codebeispiel

LayerToKML: Beispiel 1(Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion LayerToKML im Direkt-Modus verwendet wird.

import arcpy
arcpy.conversion.LayerToKML("buildings", "c:/outputKMZs/bldg.kmz")

LayerToKML: Beispiel 2 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht die Verwendung der Funktion LayerToKML in einem eigenständigen Skript.

# 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

arcpy.env.workspace = "C:/data"

# Set Local Variables
composite = 'NO_COMPOSITE'
pixels = 2048
dpi = 96
clamped = 'CLAMPED_TO_GROUND'

# Use the ListFiles method to identify all lyr and lyrx files in workspace
layers = arcpy.ListFiles("*.lyr*")

if len(layers) > 0:
    for layer in layers:
        # Strips the '.lyr(x)' part of the name and appends '.kmz'
        outKML = os.path.join(os.path.splitext(layer), ".kmz")
        for scale in range(10000, 30001, 10000):
            # Run LayerToKML
            arcpy.conversion.LayerToKML(layer, outKML, scale, composite,
                                        '', pixels, dpi, clamped)
else:
    arcpy.AddMessage('There are no layer files in {}'.format(arcpy.env.workspace))

Umgebungen

Aktueller Workspace, Ausdehnung, Scratch-Workspace, Anlagen beibehalten, Geographische Transformationen, Felddomänen-Beschreibungen übertragen

Lizenzierungsinformationen