Beschriftungen in Annotation konvertieren (Cartography)—ArcGIS Pro

Zusammenfassung

Konvertiert Beschriftungen in Annotationen für einen einzelnen Layer oder die gesamte Karte. Es können sowohl Standard- als auch Feature-bezogene Annotationen erstellt werden.

Verwendung

Beschriftungen können für einen einzelnen Layer oder die gesamte Karte in eine Annotation 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 Annotationen 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.
Annotation-Feature-Classes werden nicht überschrieben, wenn ein vorhandenes Suffix angegeben wird. In diesem Fall wird dem Suffix für die Annotation-Feature-Class eine Zahl hinzugefügt (z. B. "CitiesAnno", "CitiesAnno_1" usw.). Das vollständige Format für die Benennung lautet wie folgt:
<layer name> <duplicate feature class count> <anno suffix> <running number>
Wenn Sie Annotationen für eine Vielzahl von Bezugsmaßstäben erzeugen, konzipieren Sie die Karte für alle diese Maßstäbe, und vermeiden Sie es, in der Karte einen Bezugsmaßstab festzulegen. Sie können anschließend die Beschriftungen für jeden Maßstab in Annotationen konvertieren und entsprechend benennen, z. B. "CitiesAnno_1000", "CitiesAnno_100000" usw.
Eine Ausgabe dieses Werkzeugs ist ein Gruppen-Layer. Wenn Sie im Katalog-Bereich, im Python-Fenster oder in einem eigenständigen Python-Skript arbeiten, können Sie den Ausgabe-Gruppen-Layer mit dem Werkzeug In Layer-Datei speichern in einer Layer-Datei speichern. Bei Verwendung von ArcGIS Pro fügt das Werkzeug der Anzeige den Gruppen-Layer 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 Sie denselben Layer-Namen angeben und das Überschreiben der Ausgabe ausdrücklich zulassen.
Ist der Parameter Feature-bezogene Annotationen erstellen nicht aktiviert, kann der Parameter Beschriftungen aller Layer in eine einzige Ausgabe-Feature-Class konvertieren zum Erstellen einer Annotation-Feature-Class für die gesamte Karte verwendet werden.
Beim Erstellen einer Annotation-Feature-Class für die gesamte Karte können Beschriftungsklassen mit ähnlichen Eigenschaften über den Parameter Ähnliche Beschriftungsklassen zusammenführen zu einer Annotationsklasse zusammengeführt werden.
Feature-bezogene Annotationen werden einem spezifischen Feature in einer anderen Feature-Class der Geodatabase zugeordnet. Wenn der Parameter Feature-bezogene Annotation erstellen aktiviert ist, wird beim Erstellen der Ausgabe-Annotation-Feature-Class automatisch eine Beziehungsklasse generiert.
Wenn Sie Feature-bezogene Annotationen erstellen, muss der Ausgabe-Workspace derselbe wie der mit diesen verknüpften Feature-Classes sein.
Möglicherweise werden einige Beschriftungen nicht auf der Karte angezeigt, da kein Platz für sie vorhanden ist. Um diese Beschriftungen zu konvertieren, aktivieren Sie den Parameter Nicht platzierte Beschriftungen in nicht platzierte Annotationen konvertieren. Dadurch werden die nicht platzierten Beschriftungen in der Annotation-Feature-Class gespeichert, sodass Sie diese später in einer ArcGIS Pro-Editiersitzung positionieren können.
Die Workspaces "in_memory" und "memory" unterstützen keine Feature-bezogenen Annotationen.
Dieses Werkzeug berücksichtigt die Umgebung Feldlänge der Annotationstextzeichenfolge. Wenn diese Umgebungseinstellung festgelegt ist, wird die standardmäßige Feldlänge im Feld TextString in allen Annotation-Feature-Classes, die in einer Datenbank erstellt werden, außer Kraft gesetzt.

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabekarte	Die Eingabekarte.	Map
Konvertierungsmaßstab	Der Maßstab, in den die 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 der Annotation-Feature-Class verwendet, die Konvertierung erfolgt jedoch mit diesem Maßstab.	Double
Ausgabe-Geodatabase	Der Workspace, in dem die Ausgabe-Feature-Classes gespeichert werden. Der Workspace kann eine vorhandene Geodatabase oder ein vorhandenes Feature-Dataset sein. Wenn es sich bei dieser Datenbank nicht um die von allen Layern in der Karte verwendete Datenbank handelt, wird die Feature-bezogene Option deaktiviert.	Workspace; Feature Dataset
Annotationssuffix (optional)	Das Suffix, das jeder neuen Annotation-Feature-Class hinzugefügt wird. Dieses Suffix wird für jede neue Annotation-Feature-Class an den Namen der Quell-Feature-Class angehängt.	String
Ausdehnung (optional)	Gibt die Ausdehnung mit den Beschriftungen an, die in Annotationen konvertiert werden sollen. Default: Die Ausdehnung basiert auf der maximalen Ausdehnung aller beteiligten Layer. Dies ist die Standardeinstellung. Vereinigungsmenge der Eingaben: Die Ausdehnung basiert auf der maximalen Ausdehnung aller Eingaben. Schnittmenge der Eingaben: Die Ausdehnung basiert auf der kleinsten gemeinsamen Fläche aller Eingaben. Aktuelle Anzeigeausdehnung: Die Ausdehnung entspricht der sichtbaren Anzeige. Die Option ist nicht verfügbar, wenn keine aktive Karte vorhanden ist. Wie unten angegeben: Die Ausdehnung basiert auf den angegebenen Minimal- und Maximalwerten der Ausdehnung. Durchsuchen: Die Ausdehnung basiert auf einem vorhandenen Dataset.	Extent
Nicht platzierte Beschriftungen in nicht platzierte Annotationen konvertieren (optional)	Gibt an, ob aus nicht platzierten Beschriftungen eine nicht platzierte Annotation erstellt werden sollen. Deaktiviert: Annotationen werden nur für Features erstellt, die derzeit beschriftet sind. Dies ist die Standardeinstellung. Aktiviert: Nicht platzierte Annotationen werden in der Annotation-Feature-Class gespeichert. Das Statusfeld für diese Annotation wird auf "Nicht platziert" festgelegt.	Boolean
Auswahl eines Symbols aus der Symboltabelle erforderlich (optional)	Gibt an, ob alle oder nur bestimmte Textsymboleigenschaften bearbeitet werden können. Deaktiviert: Alle Textsymboleigenschaften können bearbeitet werden. Dies ist die Standardeinstellung. Aktiviert: Es können nur die Symboleigenschaften bearbeitet werden, die ermöglichen, dass Annotation-Features die Bezüge auf die zugehörigen Textsymbole in der Sammlung beibehalten.	Boolean
Feature-bezogene Annotationen erstellen (optional)	Hinweis: Dieser Parameter ist nur mit ArcGIS Desktop Standard- und ArcGIS Desktop Advanced-Lizenzen verfügbar. Gibt an, ob die Ausgabe-Annotation-Feature-Class mit den Features in einer anderen Feature-Class verknüpft werden. Deaktiviert: Die Ausgabe-Annotation-Feature-Class wird nicht mit den Features in einer anderen Feature-Class verknüpft. Dies ist die Standardeinstellung. Aktiviert: Die Ausgabe-Annotation-Feature-Class wird mit den Features in einer anderen Feature-Class verknüpft.	Boolean
Annotationen erstellen, sobald neue Features hinzugefügt werden (optional)	Gibt an, ob beim Hinzufügen neuer Features zur verknüpften Feature-Class eine Annotation erstellt werden soll, wenn der Parameter Feature-bezogene Annotation erstellen aktiviert ist. Aktiviert: Eine Feature-bezogene Annotation wird erstellt, wenn der verknüpften Feature-Class neue Features hinzugefügt werden. Dies ist die Standardeinstellung. Deaktiviert: Es wird keine Feature-bezogene Annotation erstellt, wenn der verknüpften Feature-Class neue Features hinzugefügt werden.	Boolean
Annotationen aktualisieren, sobald sich die Form des Features ändert (optional)	Gibt an, ob die Position der Annotation beim Aktualisieren der Form des verknüpften Features aktualisiert werden soll, wenn der Parameter Feature-bezogene Annotation erstellen aktiviert ist. Aktiviert: Die Position der Annotation wird aktualisiert, wenn sich die Form des verknüpften Features geändert hat. Dies ist die Standardeinstellung. Deaktiviert: Die Position der Annotation wird nicht aktualisiert, wenn sich die Form des verknüpften Features geändert hat.	Boolean
Ausgabe-Layer (optional)	Der Gruppen-Layer, der die erstellten Annotationen 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 dieser Option 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
Konvertieren (optional)	Gibt an, ob die Annotation für alle Layer in der Karte oder für einen einzelnen Layer konvertiert wird. Bei einem einzelnen Layer muss dieser angegeben werden. Alle Layer in der Karte—Beschriftungen werden für alle Layer in der Karte in eine Annotation konvertiert. Dies ist die Standardeinstellung. Einzelner Layer—Beschriftungen werden für einen einzelnen Layer in eine Annotation konvertiert. Der Layer muss angegeben werden.	String
Feature-Layer (optional)	Der Layer mit der Annotation, die konvertiert werden soll, wenn der Parameter Konvertieren auf Einzelner Layer festgelegt ist. Dieser Layer muss sich in der Karte befinden.	Feature Layer
Beschriftungen aller Layer in eine einzige Ausgabe-Feature-Class konvertieren (optional)	Gibt an, ob die Beschriftungen in einzelne Annotation-Feature-Classes oder nur eine einzige Annotation-Feature-Class konvertiert werden. Findet die Konvertierung in eine einzige Annotation-Feature-Class statt, kann die Annotation nicht Feature-bezogen sein. Aktiviert: Beschriftungen aller Layer werden in eine einzige Annotation-Feature-Class konvertiert. Deaktiviert: Beschriftungen werden in einzelne Annotation-Feature-Classes konvertiert, die dem jeweiligen Layer entsprechen. Dies ist die Standardeinstellung.	Boolean
Ähnliche Beschriftungsklassen zusammenführen (optional)	Gibt an, ob ähnliche Beschriftungsklassen zusammengeführt werden sollen, wenn der Parameter Beschriftungen aller Layer in eine einzige Ausgabe-Feature-Class konvertieren aktiviert ist. Aktiviert: Beschriftungsklassen mit ähnlichen Eigenschaften werden zusammengeführt, wenn der Parameter Beschriftungen aller Layer in eine einzige Ausgabe-Feature-Class konvertieren aktiviert ist. Deaktiviert: Beschriftungsklassen werden nicht zusammengeführt, wenn der Parameter Beschriftungen aller Layer in eine einzige Ausgabe-Feature-Class konvertieren aktiviert ist. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Geodatabase	Der Workspace, in dem die Ausgabe-Feature-Classes gespeichert werden.	Workspace

arcpy.cartography.ConvertLabelsToAnnotation(input_map, conversion_scale, output_geodatabase, {anno_suffix}, {extent}, {generate_unplaced}, {require_symbol_id}, {feature_linked}, {auto_create}, {update_on_shape_change}, {output_group_layer}, {which_layers}, {single_layer}, {multiple_feature_classes}, {merge_label_classes})

Name	Erläuterung	Datentyp
input_map	Die Eingabekarte.	Map
conversion_scale	Der Maßstab, in den die 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 der Annotation-Feature-Class verwendet, die Konvertierung erfolgt jedoch mit diesem Maßstab.	Double
output_geodatabase	Der Workspace, in dem die Ausgabe-Feature-Classes gespeichert werden. Der Workspace kann eine vorhandene Geodatabase oder ein vorhandenes Feature-Dataset sein. Wenn es sich bei dieser Datenbank nicht um die von allen Layern in der Karte verwendete Datenbank handelt, wird die Feature-bezogene Option deaktiviert.	Workspace; Feature Dataset
anno_suffix (optional)	Das Suffix, das jeder neuen Annotation-Feature-Class hinzugefügt wird. Dieses Suffix wird für jede neue Annotation-Feature-Class an den Namen der Quell-Feature-Class angehängt.	String
extent (optional)	Gibt die Ausdehnung mit den Beschriftungen an, die in Annotationen konvertiert werden sollen. MAXOF: Die maximale Ausdehnung aller Eingaben wird verwendet. MINOF: Die kleinste 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. Durch Leerzeichen getrennte Koordinatenzeichenfolge: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Die Koordinaten werden in der Reihenfolge X-Min, Y-Min, X-Max, Y-Max ausgedrückt. Wurde kein Ausdehnungswert angegeben, basiert die Ausdehnung auf der maximalen Ausdehnung aller beteiligten Eingaben. Dies ist die Standardeinstellung.	Extent
generate_unplaced (optional)	Gibt an, ob aus nicht platzierten Beschriftungen eine nicht platzierte Annotation erstellt werden sollen. ONLY_PLACED—Annotations werden nur für Features erstellt, die derzeit beschriftet sind. Dies ist die Standardeinstellung. GENERATE_UNPLACED—Nicht platzierte Annotationen werden in der Annotation-Feature-Class gespeichert. Das Statusfeld für diese Annotation wird auf "Nicht platziert" festgelegt.	Boolean
require_symbol_id (optional)	Gibt an, ob alle oder nur bestimmte Textsymboleigenschaften bearbeitet werden können. NO_REQUIRE_ID—Alle Textsymboleigenschaften können bearbeitet werden. Dies ist die Standardeinstellung. REQUIRE_ID—Es können nur die Symboleigenschaften bearbeitet werden, die ermöglichen, dass Annotation-Features die Bezüge auf die zugehörigen Textsymbole in der Sammlung beibehalten.	Boolean
feature_linked (optional)	Lizenz: Dieser Parameter ist nur mit ArcGIS Desktop Standard- und ArcGIS Desktop Advanced-Lizenzen verfügbar. Gibt an, ob die Ausgabe-Annotation-Feature-Class mit den Features in einer anderen Feature-Class verknüpft werden. STANDARD—Die Ausgabe-Annotation-Feature-Class wird nicht mit den Features in einer anderen Feature-Class verknüpft. Dies ist die Standardeinstellung. FEATURE_LINKED—Die Ausgabe-Annotation-Feature-Class wird mit den Features in einer anderen Feature-Class verknüpft.	Boolean
auto_create (optional)	Gibt an, ob beim Hinzufügen neuer Features zur verknüpften Feature-Class eine Annotation erstellt werden sollen, wenn der Parameter feature_linked auf FEATURE_LINKED gesetzt ist. AUTO_CREATE—Eine Feature-bezogene Annotation wird erstellt, wenn der verknüpften Feature-Class neue Features hinzugefügt werden. Dies ist die Standardeinstellung. NO_AUTO_CREATE—Es wird keine Feature-bezogene Annotation erstellt, wenn der verknüpften Feature-Class neue Features hinzugefügt werden.	Boolean
update_on_shape_change (optional)	Gibt an, ob die Position der Annotation beim Aktualisieren der Form des verknüpften Features aktualisiert werden soll, wenn der Parameter feature_linked auf FEATURE_LINKED gesetzt ist. SHAPE_UPDATE—Die Position der Annotation wird aktualisiert, wenn sich die Form des verknüpften Features geändert hat. Dies ist die Standardeinstellung. NO_SHAPE_UPDATE—Die Position der Annotation wird nicht aktualisiert, wenn sich die Form des verknüpften Features geändert hat.	Boolean
output_group_layer (optional)	Der Gruppen-Layer, der die erstellten Annotationen enthält. Sie können den Ausgabe-Gruppen-Layer mit dem Werkzeug In Layer-Datei speichern in einer Layer-Datei speichern.	Group Layer
which_layers (optional)	Gibt an, ob die Annotation für alle Layer in der Karte oder für einen einzelnen Layer konvertiert wird. Bei einem einzelnen Layer muss dieser angegeben werden. ALL_LAYERS—Beschriftungen werden für alle Layer in der Karte in eine Annotation konvertiert. Dies ist die Standardeinstellung. SINGLE_LAYER—Beschriftungen werden für einen einzelnen Layer in eine Annotation konvertiert. Der Layer muss angegeben werden.	String
single_layer (optional)	Der Layer mit der Annotation, die konvertiert werden soll, wenn der Parameter which_layers auf SINGLE_LAYER festgelegt ist. Dieser Layer muss sich in der Karte befinden.	Feature Layer
multiple_feature_classes (optional)	Gibt an, ob die Beschriftungen in einzelne Annotation-Feature-Classes oder nur eine einzige Annotation-Feature-Class konvertiert werden. Findet die Konvertierung in eine einzige Annotation-Feature-Class statt, kann die Annotation nicht Feature-bezogen sein. SINGLE_FEATURE_CLASS—Beschriftungen aller Layer werden in eine einzige Annotation-Feature-Class konvertiert. FEATURE_CLASS_PER_FEATURE_LAYER—Beschriftungen werden in einzelne Annotation-Feature-Classes konvertiert, die dem jeweiligen Layer entsprechen. Dies ist die Standardeinstellung.	Boolean
merge_label_classes (optional)	Gibt an, ob ähnliche Beschriftungsklassen zusammengeführt werden sollen, wenn der Parameter multiple_feature_classes auf SINGLE_FEATURE_CLASS gesetzt ist. MERGE_LABEL_CLASS—Beschriftungsklassen mit ähnlichen Eigenschaften werden zusammengeführt, wenn der Parameter multiple_feature_classes auf SINGLE_FEATURE_CLASS festgelegt ist. NO_MERGE_LABEL_CLASS—Beschriftungsklassen werden nicht zusammengeführt, wenn der Parameter multiple_feature_classes auf SINGLE_FEATURE_CLASS festgelegt ist. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
updated_geodatabase	Der Workspace, in dem die Ausgabe-Feature-Classes gespeichert werden.	Workspace

Codebeispiel

ConvertLabelsToAnnotation – Beispiel (Python-Fenster)

In diesem Python-Beispiel für die Funktion ConvertLabelsToAnnotation werden Beschriftungen in Annotationen für einen einzelnen Layer auf der Karte konvertiert.

import arcpy
arcpy.cartography.ConvertLabelsToAnnotation(
    'Map1', 10000, 'D:/data/Cobourg.gdb', 'Anno', 'MAXOF', 'ONLY_PLACED', 
    'REQUIRE_ID', 'STANDARD', '', '', 'AnnoLayer', 'SINGLE_LAYER', 'Schools', '', '')

ConvertLabelsToAnnotation – Beispiel 2 (eigenständiges Skript)

Dieses eigenständige Skript konvertiert Beschriftungen mithilfe der Funktion ConvertLabelsToAnnotation in Annotationen für die Karte. Die Annotation wird in eine einzige Annotation-Feature-Class konvertiert, und ähnliche Beschriftungsklassen werden zusammengeführt.

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

# import system modules

import arcpy

# Loop through the project, find all the maps, and
#   convert labels to annotation for each map,
#   using the name of the map as part of the annotation suffix 
project = arcpy.mp.ArcGISProject("D:\\data\\myproject.aprx")
for mp in project.listMaps():
    print("Converting labels to annotation for: " + mp.name)
    arcpy.cartography.ConvertLabelsToAnnotation(
            mp, 10000, 'D:/data/Cobourg.gdb', 'Anno_' + mp.name, 'MAXOF', 
            'ONLY_PLACED', 'REQUIRE_ID', 'STANDARD', '', '', 
            'AnnoLayers_' + mp.name, 'ALL_LAYERS', '', 'SINGLE_FEATURE_CLASS', 
            'MERGE_LABEL_CLASS')

Umgebungen

Ausgabe-CONFIG-Schlüsselwort, Länge der Annotation im Feld "TextString"

Lizenzinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Zusammenfassung

Verwendung

Hinweis:

Parameter

Hinweis:

Abgeleitete Ausgabe

Lizenz:

Abgeleitete Ausgabe

Codebeispiel

Umgebungen

Lizenzinformationen

Verwandte Themen

In diesem Thema