Beschriftungen in Grafik konvertieren (Cartography Tools)

Zusammenfassung

Konvertiert Beschriftungen in Grafiken für einen einzelnen Layer oder eine gesamte Karte.

Verwendung

Beschriftungen können für einen einzelnen Layer oder die gesamte Karte in Grafiken konvertiert werden. Findet die Konvertierung für einen einzelnen Layer statt, muss er angegeben werden und sich in der Karte befinden.
Die Maßstabsbereiche der Beschriftungsklassen werden berücksichtigt. Wenn das Werkzeug Grafiken für einen bestimmten Kartenmaßstab generiert, konvertiert es nur die Beschriftungsklassen, die aktiviert und bei diesem Maßstab sichtbar sind.

Hinweis:

Die Maßstabsbereiche der Beschriftungsklasse werden auf der Registerkarte Beschriftung in ArcGIS Pro festgelegt.
Das Format für die Namen der Grafik-Layer lautet <layer name><graphics layer suffix>.

Doppelt vorhandene Grafik-Layer-Namen werden nicht überschrieben.
Eine Ausgabe dieses Werkzeugs ist ein Gruppen-Layer. Sie können den Ausgabe-Gruppen-Layer mit dem Werkzeug In Layer-Datei speichern in einer Layer-Datei speichern. Bei der Verwendung in ArcGIS Pro fügt das Werkzeug den Gruppen-Layer der Anzeige hinzu. Der erstellte Gruppen-Layer ist temporär und nur für die Dauer der Sitzung vorhanden, es sei denn, das Projekt wird gespeichert.
Ein vorhandener Gruppen-Layer wird überschrieben, wenn derselbe Layer-Name angegeben wurde und die Option Geoverarbeitungswerkzeugen das Überschreiben vorhandener Datasets erlauben in den Geoverarbeitungsoptionen aktiviert ist.
Der Parameter Beschriftungen aller Layer in einen einzigen Ausgabe-Grafik-Layer konvertieren kann zum Erstellen eines Grafik-Layers für die gesamte Karte verwendet werden.
Möglicherweise werden einige Beschriftungen nicht auf der Karte angezeigt, da kein Platz für sie vorhanden ist. Aktivieren Sie das Kontrollkästchen Nicht platzierte Beschriftungen in Grafik konvertieren, um die nicht platzierten Beschriftungen im Grafik-Layer zu speichern, sodass Sie diese später sichtbar machen und positionieren können.

Beschriftung	Erläuterung	Datentyp
Eingabekarte	Der Eingabekartenname.	Map
Konvertierungsmaßstab	Der Maßstab, mit dem Beschriftungen konvertiert werden. Wenn ein Bezugsmaßstab für die Karte festgelegt ist, wird der Bezugsmaßstab zum Festlegen der Symbolgröße und zum Erstellen des Grafik-Layers verwendet, die Konvertierung erfolgt jedoch mit diesem Maßstab.	Double
Konvertieren (Optional)	Gibt an, ob die Grafik für alle Layer in der Karte oder für einen einzelnen Layer konvertiert werden soll. Alle Layer in der Karte—Beschriftungen werden für alle Layer in der Karte in eine Grafik konvertiert. Dies ist die Standardeinstellung. Einzelner Layer—Beschriftungen werden für einen einzelnen Layer in eine Grafik konvertiert. Der Layer muss mit dem Parameter Feature-Layer angegeben werden.	String
Feature-Layer (Optional)	Der Layer mit den Beschriftungen, die konvertiert werden sollen, wenn der Parameter Konvertieren auf Einzelner Layer festgelegt ist. Dieser Layer muss sich in der Karte befinden.	Feature Layer
Grafik-Layer-Suffix (Optional)	Das Suffix, das jedem neuen Grafik-Layer hinzugefügt werden soll. Dieses Suffix wird für jeden neuen Grafik-Layer an den Namen der Quell-Feature-Class angehängt.	String
Ausdehnung (Optional)	Gibt die Ausdehnung mit den Beschriftungen an, die in Grafiken konvertiert werden sollen. 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. Schnittmenge der Eingaben : Als Ausdehnung wird die überschneidende Ausdehnung aller Eingaben verwendet. Vereinigungsmenge der Eingaben : Als Ausdehnung wird die kombinierte Ausdehnung aller Eingaben verwendet. 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
Beschriftungen aller Layer in einen einzigen Ausgabe-Grafik-Layer konvertieren (Optional)	Gibt an, ob die Beschriftungen in einzelne Grafik-Layer oder nur in einen einzigen Grafik-Layer konvertiert werden sollen. Aktiviert—Beschriftungen aller Layer werden in einen einzigen Grafik-Layer konvertiert. Deaktiviert—Beschriftungen werden in einzelne Grafik-Layer konvertiert, die dem jeweiligen Layer entsprechen. Dies ist die Standardeinstellung.	Boolean
Nicht platzierte Beschriftungen in Grafik konvertieren (Optional)	Gibt an, ob aus nicht platzierten Beschriftungen Grafiken erstellt werden sollen. Aktiviert—Nicht platzierte Grafiken werden mit deaktivierter Sichtbarkeit im Grafik-Layer gespeichert. Deaktiviert—Grafiken werden nur für Features erstellt, die derzeit beschriftet sind. Dies ist die Standardeinstellung.	Boolean
Ausgabe-Layer (Optional)	Der Gruppen-Layer, der die erstellten Grafiken enthält. Im Bereich Katalog können Sie den Ausgabe-Gruppen-Layer mit dem Werkzeug In Layer-Datei speichern in einer Layer-Datei speichern. Bei der Verwendung von ArcGIS Pro in einer geöffneten Karte und Aktivierung der Option Einer geöffneten Karte Ausgabe-Datasets hinzufügen in den Geoverarbeitungsoptionen fügt das Werkzeug den Gruppen-Layer der Anzeige hinzu. Der erstellte Gruppen-Layer ist temporär und nur für die Dauer der Sitzung vorhanden, es sei denn, das Projekt wird gespeichert.	Group Layer

arcpy.cartography.ConvertLabelsToGraphics(input_map, conversion_scale, {which_layers}, {single_layer}, {graphics_suffix}, {extent}, {multiple_graphics_layers}, {generate_unplaced}, {output_group_layer})

Name	Erläuterung	Datentyp
input_map	Das Eingabekartenobjekt.	Map
conversion_scale	Der Maßstab, mit dem Beschriftungen konvertiert werden. Wenn ein Bezugsmaßstab für die Karte festgelegt ist, wird der Bezugsmaßstab zum Festlegen der Symbolgröße und zum Erstellen des Grafik-Layers verwendet, die Konvertierung erfolgt jedoch mit diesem Maßstab.	Double
which_layers (Optional)	Gibt an, ob die Grafik für alle Layer in der Karte oder für einen einzelnen Layer konvertiert werden soll. `ALL_LAYERS`—Beschriftungen werden für alle Layer in der Karte in eine Grafik konvertiert. Dies ist die Standardeinstellung. `SINGLE_LAYER`—Beschriftungen werden für einen einzelnen Layer in eine Grafik konvertiert. Der Layer muss mit dem Parameter `single_layer` angegeben werden.	String
single_layer (Optional)	Der Layer mit den Beschriftungen, die konvertiert werden sollen, wenn der Parameter `which_layers` auf `SINGLE_LAYER` festgelegt ist. Dieser Layer muss sich in der Karte befinden.	Feature Layer
graphics_suffix (Optional)	Das Suffix, das jedem neuen Grafik-Layer hinzugefügt werden soll. Dieses Suffix wird für jeden neuen Grafik-Layer an den Namen der Quell-Feature-Class angehängt.	String
extent (Optional)	Gibt die Ausdehnung mit den Beschriftungen an, die in Grafiken konvertiert werden sollen. `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
multiple_graphics_layers (Optional)	Gibt an, ob die Beschriftungen in einzelne Grafik-Layer oder nur in einen einzigen Grafik-Layer konvertiert werden sollen. `SINGLE_GRAPHICS_LAYER`—Beschriftungen aller Layer werden in einen einzigen Grafik-Layer konvertiert. `GRAPHICS_LAYER_PER_FEATURE_LAYER`—Beschriftungen werden in einzelne Grafik-Layer konvertiert, die dem jeweiligen Layer entsprechen. Dies ist die Standardeinstellung.	Boolean
generate_unplaced (Optional)	Gibt an, ob aus nicht platzierten Beschriftungen Grafiken erstellt werden sollen. `GENERATE_UNPLACED`—Nicht platzierte Grafiken werden mit deaktivierter Sichtbarkeit im Grafik-Layer gespeichert. `ONLY_PLACED`—Grafiken werden nur für Features erstellt, die derzeit beschriftet sind. Dies ist die Standardeinstellung.	Boolean
output_group_layer (Optional)	Der Gruppen-Layer, der die erstellten Grafiken enthält. Sie können den Ausgabe-Gruppen-Layer mit dem Werkzeug In Layer-Datei speichern in einer Layer-Datei speichern.	Group Layer

Codebeispiel

ConvertLabelsToGraphics: Beispiel 1 (Python-Fenster)

Python-Beispiel für die Funktion ConvertLabelsToGraphics, die Beschriftungen in Grafiken für einen einzelnen Layer konvertiert.

import arcpy
arcpy.cartography.ConvertLabelsToGraphics(
    'Map1', 10000, 'SINGLE_LAYER', 'Schools', 'Graphics', 'MAXOF',
    'GRAPHICS_LAYER_PER_FEATURE_LAYER', 'ONLY_PLACED', 'GroupGraphics')

ConvertLabelsToGraphics: Beispiel 2 (eigenständiges Skript)

Eigenständiges Skript, das Beschriftungen mithilfe der Funktion ConvertLabelsToGraphics in Grafiken für die Karte konvertiert.

# Name: ConvertLabelsToGraphics.py
# Description: Find all the maps in the project and
#              convert labels to graphics for each map

# import system modules

import arcpy

# Loop through the project, find all the maps, and
#   convert labels to graphics for each map,
#   using the name of the map as part of the graphics layer suffix
project = arcpy.mp.ArcGISProject("D:\\data\\myproject.aprx")
for mp in project.listMaps():
    print("Converting labels to graphics for: " + mp.name)
    arcpy.cartography.ConvertLabelsToGraphics(
            mp, 10000, 'ALL_LAYERS', '', 'Graphics_' + mp.name, 'MAXOF',
            'GRAPHICS_LAYER_PER_FEATURE_LAYER', 'ONLY_PLACED',
            'GraphicsLayers_' + mp.name)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja