Karte in KML (Conversion Tools)

Zusammenfassung

Konvertiert eine Karte, die Feature- oder Raster-Layer enthält, in das KML-Format (.kmz-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

Bei der .kmz-Ausgabedatei handelt es sich um eine Archiv- oder .zip-Datei, die eine .kml- und weitere zusätzliche 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 Kartenausgabe angeben.
Die Layer der Eingabekarte werden in das Koordinatensystem WGS84 projiziert, da dieses von allen .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 Karten-Layer auch mit dem Werkzeug Projizieren mit einer gültigen Transformation erneut in das Koordinatensystem WGS84 projizieren, bevor Sie sie in KML konvertieren.
Die Parameter Maßstab für Kartenausgabe 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 Kartenausgabe der Wert 1 festgelegt wird, enthält jedes Sub-Bild 1000 x 1000 Pixel. Wenn für den Parameter Maßstab für Kartenausgabe der Wert 10 festgelegt wird, enthält jedes Sub-Bild 100 x 100 Pixel.
Wenn Sie in die KML-Ausgabedatei als Bildschirm-Overlay eine Legende einbeziehen möchten, geben Sie einen Wert für den Parameter Quelle des Legenden-Layouts an. Hierfür muss das Kartenlayout ein Legendenelement aufweisen.

Nur Legendenelemente können in KML-Dateien zu Bildschirm-Overlays werden. Dabei wird jede Legende beim Betrachten der KML-Daten zu einem Unterordner im KML-Hauptordner.

Beschriftung	Erläuterung	Datentyp
Eingabekarte	Die Karte, Szene oder Grundkarte, die in das KML-Format konvertiert wird.	Map
Ausgabedatei (KMZ)	Die KML-Ausgabedatei, die komprimiert ist und die Erweiterung `.kmz` hat.	File
Maßstab für Kartenausgabe (Optional)	Der Maßstab, mit dem jeder Layer in der Karte exportiert wird. Dieser Parameter ist bei Maßstabsabhängigkeit wichtig, z. B. für Layer-Sichtbarkeit oder maßstabsabhängiges Rendering. Wenn der Layer im Maßstab der Ausgabe nicht sichtbar ist, wird er nicht in die KML-Ausgabedatei einbezogen. Jeder Wert, z. B. 1, kann verwendet werden, wenn es keine Maßstabsabhängigkeiten gibt. 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. Es werden nur numerische Zeichen akzeptiert. Geben Sie beispielsweise 20000 als Maßstab ein, nicht etwa 1:20000. In Sprachen, in denen als Dezimaltrennzeichen das Komma verwendet wird, ist auch die Eingabe 20,000 zulässig. Wenn Sie einen Layer exportieren, der in Form von 3D-Vektoren angezeigt werden soll, und der Parameter Einzelnes zusammengesetztes Bild zurückgeben aktiviert ist, können Sie diesen Parameter auf jeden Wert setzen, solange die Features nicht maßstabsabhängig gerendert werden müssen.	Double
Einzelnes zusammengesetztes Bild zurückgeben (Optional)	Gibt an, ob die KML-Ausgabedatei ein einzelnes zusammengesetztes Bild oder separate Layer enthält. Aktiviert—Die Ausgabe-KML enthält nur ein einzelnes Bild, das alle Features in der Karte in einem Rasterbild zusammenfasst. Das Raster wird als KML-`GroundOverlay` über ein Terrain gelegt. Diese Option reduziert die Größe der KML-Ausgabedatei. Einzelne Features und Layer sind dann in der KML-Ausgabe nicht auswählbar. Deaktiviert—Die KML-Ausgabedatei enthält einzelne separate Layer. Dies ist die Standardeinstellung. Ob die Layer als Raster oder als Kombination aus Vektoren und Rastern zurückgegeben werden, wird vom Parameter Features in Bilder konvertieren bestimmt.	Boolean
Features in Bilder konvertieren (Optional)	Gibt an, ob jeder Feature-Layer in der Karte in ein separates Raster-Bild konvertiert wird oder ob die Features beibehalten werden. Dieser Parameter wird nicht verwendet, wenn der Parameter Einzelnes zusammengesetztes Bild zurückgeben aktiviert wird. Aktiviert—Feature-Layer werden in der KML-Ausgabe in ein separates Raster-Bild konvertiert. Der KML-Ausgabe werden auch normale Raster-Layer hinzugefügt. Jedes KML-Ausgabe-Raster ist auswählbar und seine Transparenz kann in bestimmten KML-Viewer-Anwendungen angepasst werden. Deaktiviert—Features bleiben in der KML-Ausgabe als Feature-Geometrien erhalten. Dies ist die Standardeinstellung.	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 Kartenausgabe 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 eines beliebigen Rasters im KML-Ausgabedokument. Die typische Bildschirmauflösung beträgt 96 dpi. Wenn die Daten in der Karte eine hohe Auflösung unterstützen und dies für die KML-Ausgabe erforderlich ist, können Sie den Wert möglicherweise vergrößern. Verwenden Sie diesen Parameter mit dem Parameter Größe des zurückgegebenen Bildes (Pixel), um die Auflösung des Ausgabebildes zu steuern. Der Standardwert ist 96.	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
Quelle des Legenden-Layouts (Optional)	Der Name des Layouts, das Legendenelemente enthält, welche als Bildschirm-Overlays in die KML-Ausgabe einbezogen werden.	String

arcpy.conversion.MapToKML(in_map, out_kmz_file, {map_output_scale}, {is_composite}, {is_vector_to_raster}, {extent_to_export}, {image_size}, {dpi_of_client}, {ignore_zvalue}, {layout})

Name	Erläuterung	Datentyp
in_map	Die Karte, Szene oder Grundkarte, die in das KML-Format konvertiert wird.	Map
out_kmz_file	Die KML-Ausgabedatei, die komprimiert ist und die Erweiterung `.kmz` hat.	File
map_output_scale (Optional)	Der Maßstab, mit dem jeder Layer in der Karte exportiert wird. Dieser Parameter ist bei Maßstabsabhängigkeit wichtig, z. B. für Layer-Sichtbarkeit oder maßstabsabhängiges Rendering. Wenn der Layer im Maßstab der Ausgabe nicht sichtbar ist, wird er nicht in die KML-Ausgabedatei einbezogen. Jeder Wert, z. B. 1, kann verwendet werden, wenn es keine Maßstabsabhängigkeiten gibt. 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. Es werden nur numerische Zeichen akzeptiert. Geben Sie beispielsweise 20000 als Maßstab ein, nicht etwa 1:20000. In Sprachen, in denen als Dezimaltrennzeichen das Komma verwendet wird, ist auch die Eingabe 20,000 zulässig. Wenn Sie einen Layer exportieren, der in Form von 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.	Double
is_composite (Optional)	Gibt an, ob die KML-Ausgabedatei ein einzelnes zusammengesetztes Bild oder separate Layer enthält. `COMPOSITE`—Die Ausgabe-KML enthält nur ein einzelnes Bild, das alle Features in der Karte in einem Rasterbild zusammenfasst. Das Raster wird als KML-`GroundOverlay` über ein Terrain gelegt. Diese Option reduziert die Größe der KML-Ausgabedatei. Einzelne Features und Layer sind dann in der KML-Ausgabe nicht auswählbar. `NO_COMPOSITE`—Die KML-Ausgabedatei enthält einzelne separate Layer. Dies ist die Standardeinstellung. Ob die Layer als Raster oder als Kombination aus Vektoren und Rastern zurückgegeben werden, wird vom Parameter `is_vector_to_raster` bestimmt.	Boolean
is_vector_to_raster (Optional)	Gibt an, ob jeder Feature-Layer in der Karte in ein separates Raster-Bild konvertiert wird oder ob die Features beibehalten werden. Der Parameter wird nicht verwendet, wenn der Parameter `is_composite` auf `COMPOSITE` festgelegt ist. `VECTOR_TO_IMAGE`—Feature-Layer werden in der KML-Ausgabe in ein separates Raster-Bild konvertiert. Der KML-Ausgabe werden auch normale Raster-Layer hinzugefügt. Jedes KML-Ausgabe-Raster ist auswählbar und seine Transparenz kann in bestimmten KML-Viewer-Anwendungen angepasst werden. `VECTOR_TO_VECTOR`—Features bleiben in der KML-Ausgabe als Feature-Geometrien erhalten. Dies ist die Standardeinstellung.	Boolean
extent_to_export (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 `map_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 eines beliebigen Rasters im KML-Ausgabedokument. Die typische Bildschirmauflösung beträgt 96 dpi. Wenn die Daten in der Karte eine hohe Auflösung unterstützen und dies für die KML-Ausgabe erforderlich ist, können Sie den Wert möglicherweise vergrößern. Verwenden Sie diesen Parameter mit dem Parameter `image_size`, um die Auflösung des Ausgabebildes zu steuern. Der Standardwert ist 96.	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
layout (Optional)	Der Name des Layouts, das Legendenelemente enthält, welche als Bildschirm-Overlays in die KML-Ausgabe einbezogen werden.	String

Codebeispiel

MapToKML: Beispiel 1(Python-Fenster)

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

import arcpy
arcpy.conversion.MapToKML("C:/Maps/Cities.mapx", "C:/OutputMaps/Cities.kmz")

MapToKML: Beispiel 2 (eigenständiges Skript)

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

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Use ListFiles to identify all map files in workspace
files = arcpy.ListFiles('*.mapx')
if len(files) > 0:
    for map_file in files:
        # Set Local Variables
        composite = 'NO_COMPOSITE'
        vector = 'VECTOR_TO_VECTOR'
        pixels = 2048
        dpi = 96
        clamped = 'ABSOLUTE'
        for scale in range(10000, 20000, 30000):
            # Strips the '.mapx' part of the name and appends '.kmz'
            outKML = map_file[:-5]+'.kmz'

            # Run MapToKML
            arcpy.conversion.MapToKML(map_file, outKML, scale, composite,
                                      vector, '', pixels, dpi, clamped)
else:
    arcpy.AddMessage('There are no map files (*.mapx) in {}.'.format(arcpy.env.workspace))

Umgebungen

Aktueller Workspace, Ausdehnung, Scratch-Workspace, Anlagen beibehalten, Geographische Transformationen

Lizenzierungsinformationen