Beschriftung | Erläuterung | Datentyp |
Eingabe-Layer | Der Feature- oder Raster-Layer oder der Gruppen-Layer, der in das KML-Format konvertiert werden soll. | 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 haben und eine einfache Datei im KML-Format erzeugen. Die Erweiterung .kmz für die Ausgabedatei ist die Standardeinstellung. Die .kmz-Ausgabedateien unterstützen Raster-Layer, Symbolisierung und andere Layer-Eigenschaften, Anlagen und andere erweiterte Features. Die .kml-Ausgabedateien verwenden grundlegende KML-Symbole und -Eigenschaften. | File |
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 für die Ausgabedatei das Format .kmz-Format angeben, da .kml-Ausgabedateien keine Boden-Overlay-Bilder oder Raster unterstützen.
| Boolean |
Ausdehnung (optional) | Die geographische Ausdehnung des zu konvertierenden Layers. Es werden nur Features oder Rasterzellen in dieser Ausdehnung in die KML-Ausgabe einbezogen.
| 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 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.
| Boolean |
Zusammenfassung
Konvertiert einen 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.
Verwendung
Die Standardausgabe des Werkzeugs hat eine .kmz-Erweiterung 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, einschließlich ArcGIS Earth und Google Earth.
Es gibt folgende zwei Möglichkeiten zum Steuern der Darstellung von KML-Daten:
- Die Pop-up-Anzeige setzt sich standardmäßig aus allen sichtbaren Feldern des Layers zusammen. Pop-up-Anzeigen können auch mit den HTML-Pop-up-Eigenschaften 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 keine Layer-Eigenschaften festgelegt wurden und die Feature-Class bestimmte Attribute (Felder) enthält, werden die Feldeigenschaften bei der Erstellung der ursprünglich mit dem Werkzeug KML in Layer erstellten KML-Layer verwendet. Diese enthalten Attribute, die definieren, wie KML erstellt wird. Weitere Informationen zum Erstellen von KML 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 Rasterzellen in der Projektion präzise verortet werden, müssen Sie möglicherweise die Umgebungseinstellung "Geographische Transformation" verwenden. Sie können den Eingabe-Layer auch mit dem Werkzeug Projizieren mit einer gültigen Transformation erneut in das Koordinatensystem WGS84 projizieren, bevor Sie ihn 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 PDF-Dokumente.
Anlagen werden nicht einbezogen, wenn die Ausgabe eine .kml-Datei ist.
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.
Parameter
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 werden soll. | 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 haben und eine einfache Datei im KML-Format erzeugen. Die Erweiterung .kmz für die Ausgabedatei ist die Standardeinstellung. Die .kmz-Ausgabedateien unterstützen Raster-Layer, Symbolisierung und andere Layer-Eigenschaften, Anlagen und andere erweiterte Features. Die .kml-Ausgabedateien verwenden grundlegende KML-Symbole und -Eigenschaften. | File |
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 für die KML-Ausgabedatei das Format .kmz angeben, da .kml-Ausgabedateien keine Boden-Overlay-Bilder oder Raster unterstützen.
| Boolean |
boundary_box_extent (optional) | Die geographische Ausdehnung des zu konvertierenden Layers. Es werden nur Features oder Rasterzellen in dieser Ausdehnung in die KML-Ausgabe einbezogen. Die Ausdehnung kann mit den folgenden Optionen konfiguriert werden:
| 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 image_size-Parameter, um die Auflösung des Ausgabebildes zu steuern. Dieser Parameter ermöglicht kein Resampling von Quell-Rastern. Von 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.
| Boolean |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion LayerToKML im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.conversion.LayerToKML("buildings", "c:/outputKMZs/bldg.kmz")
Das folgende Python-Skript veranschaulicht, wie die Funktion LayerToKML in einem eigenständigen Skript verwendet wird.
# 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
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja