Beschriftungen in Annotation konvertieren (Kartografie)

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 jeden dieser Maßstäbe, und legen Sie keinen Bezugsmaßstab in der Karte fest. 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 sind mit einem speziellen Feature in einer anderen Feature-Class in der Geodatabase verknüpft. 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 Memory und in_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

Dialogfeld

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. Aktuelle Anzeigeausdehnung : Die Ausdehnung basiert auf der aktiven Karte oder Szene. Diese Option ist nur verfügbar, wenn eine aktive Karte vorhanden ist. Ausdehnung darstellen : Die Ausdehnung basiert auf einem Rechteck, das auf der Karte oder Szene aufgezogen wurde. Bei dieser Option wird eine Feature-Class in der Projekt-Geodatabase erstellt und ein Layer zur Karte hinzugefügt. Das Koordinatensystem der Feature-Class stimmt mit dem der Karte überein. Hinweis: Diese Option ist im Dialogfeld Umgebungen nicht verfügbar. Sie ist nur über einen Werkzeugparameter mit dem Datentyp "Ausdehnung" oder über die Registerkarte Umgebungen eines Werkzeugdialogfeldes verfügbar. Hinweis: Wenn die Bearbeitungsoption Bearbeitung über die Registerkarte "Bearbeiten" aktivieren und deaktivieren aktiviert ist, dann müssen Sie auf der Registerkarte Bearbeiten des Menübands die Bearbeitung aktivieren, um die Ausdehnung darzustellen. Ausdehnung eines Layers: Die Ausdehnung basiert auf einem aktiven Karten-Layer. Verwenden Sie die Dropdown-Liste, um einen verfügbaren Layer auszuwählen, oder verwenden Sie die Option Ausdehnung von Daten in allen Layern, um die kombinierte Ausdehnung aller aktiven Karten-Layer mit Ausnahme der Grundkarte zu erhalten. Diese Option ist nur verfügbar, wenn eine aktive Karte mit Layern vorhanden ist. Jeder Karten-Layer bietet die folgenden Optionen: Alle Features : Die Ausdehnung aller Features im Layer. Ausgewählte Features: Die Ausdehnung der ausgewählten Features im Layer. Sichtbare Features : Die Ausdehnung sichtbarer Features im Layer. Hinweis: Die Ausdehnungen der Optionen Ausgewählte Features und Sichtbare Features sind nur für Feature-Layer verfügbar. Durchsuchen: Die Ausdehnung basiert auf einem vorhandenen Dataset. Schnittmenge der Eingaben : Die Ausdehnung basiert auf der kleinsten oder überschneidenden Ausdehnung aller Eingaben. Wenn sich keine Eingaben überschneiden, entsteht eine Nullausdehnung. Vereinigungsmenge der Eingaben: Die Ausdehnung basiert auf der maximalen oder kombinierten Ausdehnung aller Eingaben. Zwischenablage : Die Ausdehnung kann in die und aus der Zwischenablage kopiert werden. Ausdehnung kopieren : Kopiert die Ausdehnungskoordinaten und das Ausdehnungskoordinatensystem in die Zwischenablage. Ausdehnung einfügen : Fügt die Ausdehnungskoordinaten und optional das Koordinatensystem aus der Zwischenablage ein. Wenn die Werte in der Zwischenablage kein Koordinatensystem beinhalten, wird für die Ausdehnung das Koordinatensystem der Karte verwendet. Hinweis: Beim Kopieren der Ausdehnungskoordinaten in die und Einfügen aus der Zwischenablage wird dieselbe Formatierung und Reihenfolge wie beim ArcPy-Objekt Extent verwendet: X-Min, Y-Min, X-Max, Y-Max und der Raumbezug. Ausdehnung zurücksetzen: Die Ausdehnung wird auf den Standardwert zurückgesetzt. Manuell eingegebene Koordinaten: Die Koordinaten müssen numerische Werte sein und im Koordinatensystem der aktiven Karte liegen. Vorsicht: Die Karte kann statt der eingegebenen Koordinaten auch andere Anzeigeeinheiten verwenden. Die Verwendung einer Kardinalrichtung (N, S, O, W) wird nicht unterstützt. Verwenden Sie für die Koordinaten in Richtung Süden und Westen Werte mit negativem Vorzeichen.	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 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)	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 eine Annotation erstellt werden soll, wenn neue Features zur verknüpften Feature-Class hinzugefügt werden und 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 aktualisiert wird, wenn die Form des verknüpften Features geändert wird und 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 wird, 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 in eine einzige Feature-Class konvertiert wird. Deaktiviert: Beschriftungsklassen mit ähnlichen Eigenschaften werden nicht zusammengeführt. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

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

Python

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 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. 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 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)	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 eine Annotation erstellt werden soll, wenn neue Features zur verknüpften Feature-Class hinzugefügt werden und der Parameter feature_linked auf FEATURE_LINKED festgelegt 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 aktualisiert wird, wenn die Form des verknüpften Features geändert wird und der Parameter feature_linked auf FEATURE_LINKED festgelegt 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 wird, 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 in eine einzige Feature-Class konvertiert wird. NO_MERGE_LABEL_CLASS—Beschriftungsklassen mit ähnlichen Eigenschaften werden nicht zusammengeführt. 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