| Beschriftung | Erläuterung | Datentyp |
Eingabe-Layer | Das Feature, der Raster-Layer oder die Layer-Datei (.lyrx) für die Konvertierung ins KML-Format. | Feature Layer; Raster Layer; Mosaic Layer; Group Layer; Layer File |
Ausgabedatei (.kmz oder .kml) | Die .kmz- oder .kml-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 .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 die Ausgabedatei im KML-Format mit einer .kmz-Erweiterung angeben, da .kml-Ausgabedateien keine Boden-Overlay-Bilder oder Raster unterstützen.
| Boolean |
Ausdehnung für Export (optional) | Die geographische Ausdehnung des zu exportierenden Gebiets. Definieren Sie das Ausdehnungsfeld (im WGS84-Koordinatensystem), oder wählen Sie einen Layer bzw. ein Dataset aus, der bzw. das eine Ausdehnung definiert.
| Extent |
Größe des zurückgegebenen Bildes (Pixel) (optional) | Die Größe der Kacheln für Raster-Layer, wenn für den Parameter Maßstab für Layer-Ausgabe ein Wert größer als oder gleich 1 festgelegt wird. Dieser Parameter hat keine Auswirkungen auf Layer, die keine Raster-Layer sind. | Long |
DPI des Ausgabebilds (optional) | Die Geräteauflösung für die KML-Ausgabe, wenn der Parameter Einzelnes zusammengesetztes Bild zurückgeben aktiviert wird. Dieser Parameter wird mit dem Parameter Größe des zurückgegebenen Bildes (Pixel) verwendet, um die Ausgabe-Bildauflösung 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 |
Am Boden fixierte Features (optional) | Gibt an, ob die Z-Werte der Eingabe-Features überschrieben werden.
| Boolean |
Zusammenfassung
Wandelt ein Feature oder einen Raster-Layer in das KML-Format um (.kmz- oder .kml-Datei), das eine Konvertierung der Esri Geometrien und Symbolisierung enthält.
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 hat, sollten Sie die Größe der .kmz-Ausgabedatei reduzieren, indem Sie einen geeigneten Wert für den Parameter Maßstab für Layer-Ausgabe wählen.
Alle .kml- und .kmz-Dateien werden im WGS84-Koordinatensystem erstellt. Stellen Sie sicher, dass der Eingabe- Layer korrekt projiziert wird, wenn er nicht in WGS84 vorliegt. Sie können das Werkzeug Projizieren verwenden, um die Daten vor der KML-Konvertierung neu zu projizieren, wenn für die Projektion der Eingabe eine Transformation erforderlich ist.
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 1.000 x 1.000 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 | Das Feature, der Raster-Layer oder die Layer-Datei (.lyrx) für die Konvertierung ins KML-Format. | Feature Layer; Raster Layer; Mosaic Layer; Group Layer; Layer File |
out_kmz_file | Die .kmz- oder .kml-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 .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 die Ausgabedatei im KML-Format mit einer .kmz-Erweiterung angeben, da .kml-Ausgabedateien keine Boden-Overlay-Bilder oder Raster unterstützen.
| Boolean |
boundary_box_extent (optional) | Die geographische Ausdehnung des zu exportierenden Gebiets. Die Grenzen des Ausdehnungsrechtecks werden als eine durch Leerzeichen getrennte Zeichenfolge in WGS84-Koordinaten nach dem Schema unten links und rechts oben (x-min, y-min, x-max, y-max) angegeben.
| Extent |
image_size (optional) | Die Größe der Kacheln für Raster-Layer, wenn für den Parameter layer_output_scale ein Wert größer als oder gleich 1 festgelegt wird. 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. Dieser Parameter wird mit dem Parameter image_size verwendet, um die Ausgabe-Bildauflösung 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 überschrieben 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 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))