Skip To Content

Gekachelte Beschriftungen in Annotation

Zusammenfassung

Konvertiert Beschriftungen für Layer in einem Kartendokument auf der Grundlage eines Polygon-Index-Layers in Annotationen.

Das Werkzeug unterteilt eine Karte in Kacheln und erstellt dann für jede Kachel Annotationen. Dies ist beim Konvertieren einer großen Anzahl von Beschriftungen in Annotationen nützlich. Der Polygon-Index-Layer kann mit dem Werkzeug Kachelschema des Kartenserver-Cache in Polygone oder Indexgitter-Features generiert werden oder es kann sich um eine beliebige andere Polygon-Feature-Class handeln, die den Bereich für die zu erstellenden Annotationen umfasst.

Verwendung

  • Die Maßstabsbereiche der Beschriftungsklassen werden berücksichtigt. Wenn das Werkzeug Annotationen für einen bestimmten Bezugsmaßstab generiert, konvertiert es nur die Beschriftungsklassen, die aktiviert und bei diesem Maßstab sichtbar sind.

    Hinweis:

    Maßstabsbereiche für Beschriftungsklassen werden in ArcGIS Pro in den Eigenschaften des Layers festgelegt. Konfigurieren Sie die Beschriftungseigenschaften, und speichern Sie das Projekt, bevor Sie dieses Werkzeug ausführen.

  • Wenn Sie vor dem Ausführen des Werkzeugs Kacheln auswählen, werden nur für die ausgewählten Kacheln Annotationen erstellt.

  • Wenn nur die Annotationen für einige Kacheln im Polygon-Index-Layer aktualisiert werden sollen, wählen Sie zuerst die Annotation-Features mit genau diesem "TileID"-Wert aus, und löschen Sie sie. Wählen Sie dann die Polygon-Features aus, und führen Sie das Werkzeug erneut aus.

  • Eine der Ausgaben dieses Werkzeugs ist eine Reihe von Gruppen-Layern. Einer der Gruppen-Layer enthält einen Gruppen-Layer für jeden Bezugsmaßstab, für den Annotationen erstellt wurden.

  • Im Bereich "Katalog" oder in ModelBuilder können Sie den Ausgabe-Gruppen-Layer mit dem Werkzeug In Layer-Datei speichern in einer Layer-Datei speichern.

  • Ein vorhandener Gruppen-Layer wird überschrieben, wenn Sie denselben Layer-Namen angeben und das Überschreiben von Ausgaben ausdrücklich zulassen.

  • Wenn in der Karte doppelte Feature-Class-Namen gefunden werden, wird der Annotation nach dem Feature-Class-Namen eine Zahl angefügt (z. B. "Cities01Anno10000", "Cities02Anno10000" usw.).

  • Annotation-Feature-Classes werden nicht überschrieben, wenn ein bereits vorhandener Suffix angegeben wird. In diesem Fall wird dem Suffix für die Annotation-Feature-Class eine Zahl hinzugefügt (z. B. "CitiesAnno10000", "CitiesAnno10000_1" usw.).

  • Der Bezugsmaßstab für die Annotation-Feature-Classes kann auf zwei Arten angegeben werden:

    • Die erste Option besteht darin, den Bezugsmaßstab der Ausgabe-Annotation-Feature-Classes anhand eines Feldes des Polygon-Index-Layers zu ermitteln. Verwenden Sie diese Option, wenn Sie Annotationen für eine Vielzahl von Maßstabsebenen erstellen.
    • Die zweite Option besteht in der expliziten Angabe eines Bezugsmaßstabs. Dieser Bezugsmaßstab wird für alle Annotation-Feature-Classes verwendet. Wenn in der Karte ein Bezugsmaßstab festgelegt wird, ist dies der Standardwert für das Werkzeug. Wenn kein Bezugsmaßstab in der Karte festgelegt ist, wird der aktuelle Maßstab als Standardwert angegeben.

  • Wenn Sie einen Polygonindex-Layer verwenden, der vom Werkzeug Kachelschema des Kartenserver-Cache in Polygone erstellt wurde, verwenden Sie das Feld Tile_Scale als Bezugsmaßstabsfeld. Für jede Kombination aus Layer und "Tile_Scale" wird eine neue Annotation-Feature-Class erstellt.

  • Erzeugen Sie Annotationen für eine Vielzahl von Bezugsmaßstäben, konzipieren Sie die Karte für jeden dieser Maßstäbe, und legen Sie keinen Bezugsmaßstab fest.

  • Wird ein Koordinatensystemfeld aus dem Polygon-Index-Layer angegeben, wird die Annotation für jede Kachel zum Zweck der Darstellung und Platzierung in dieses Koordinatensystem projiziert.

  • Feature-bezogene Annotationen werden einem spezifischen Feature in einer anderen Feature-Class der Geodatabase zugeordnet. Wenn Sie die Option ausgewählt haben, wird ferner automatisch eine Beziehungsklasse generiert, wenn Sie die Ausgabe-Annotation-Feature-Class erstellen.

  • 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 momentan nicht auf der Karte angezeigt, da kein Platz für sie vorhanden ist. Um diese Beschriftungen zu konvertieren, aktivieren Sie das Kontrollkästchen Nicht platzierte Annotation erstellen. Dadurch werden die nicht platzierten Beschriftungen in der Annotation-Feature-Class gespeichert, sodass Sie diese später in einer Editiersitzung positionieren können.

Syntax

TiledLabelsToAnnotation_cartography (input_map, polygon_index_layer, out_geodatabase, out_layer, anno_suffix, {reference_scale_value}, {reference_scale_field}, {tile_id_field}, {coordinate_sys_field}, {map_rotation_field}, {feature_linked}, {generate_unplaced_annotation})
ParameterErläuterungDatentyp
input_map

Die Karte mit den Beschriftungen, die in Annotationen konvertiert werden sollen.

Map
polygon_index_layer

Der Polygon-Layer, der Kachel-Features enthält.

Table View
out_geodatabase

Der Workspace, in dem die Ausgabe-Feature-Classes gespeichert werden. Der Workspace kann eine vorhandene Geodatabase oder ein vorhandenes Feature-Dataset sein.

Workspace ;Feature Dataset
out_layer

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
anno_suffix

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. Der Bezugsmaßstab für die Annotation folgt auf dieses Suffix.

String
reference_scale_value
(optional)

Gibt den Maßstabswert an, der als Bezugsmaßstab für die Annotation verwendet werden soll. Alle Symbol- und Textgrößen in der Annotation werden relativ zu diesem Maßstab angezeigt.

Double
reference_scale_field
(optional)

Gibt das Feld im Polygon-Index-Layer an, das den Bezugsmaßstab der Annotation festlegt. Alle Symbol- und Textgrößen in der Annotation werden relativ zu diesem Maßstab angezeigt.

Field
tile_id_field
(optional)

Ein Feld im Polygon-Index-Layer, das die gekachelte Fläche eindeutig identifiziert. Mit diesen Werten wird das Feld "TileID" in der Attributtabelle der Annotation-Feature-Class ausgefüllt.

Field
coordinate_sys_field
(optional)

Ein Feld im Polygon-Index-Layer, das das Koordinatensystem für jede Kachel enthält. Aufgrund der zur Speicherung eines Koordinatensystems erforderlichen Feldlänge muss ein Polygon-Index-Layer, der ein Koordinatensystemfeld enthält, eine Geodatabase-Feature-Class sein.

Field
map_rotation_field
(optional)

Ein Feld im Polygon-Index-Layer, das den Winkel enthält, um den der Datenrahmen gedreht werden soll.

Field
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_LINKEDDie Ausgabe-Annotation-Feature-Class wird mit den Features in einer anderen Feature-Class verknüpft.
Boolean
generate_unplaced_annotation
(optional)

Gibt an, ob aus nicht platzierten Beschriftungen nicht platzierte Annotationen erstellt werden sollen.

  • NOT_GENERATE_UNPLACED_ANNOTATIONAnnotations werden nur für Features erstellt, die derzeit beschriftet sind. Dies ist die Standardeinstellung.
  • GENERATE_UNPLACED_ANNOTATIONNicht platzierte Annotationen werden in der Annotation-Feature-Class gespeichert. Das Statusfeld für diese Annotation wird auf "Nicht platziert" festgelegt.
Boolean

Codebeispiel

TiledLabelsToAnnotation – Beispiel (Python-Fenster)

Python-Beispiel für TiledLabelsToAnnotation, das Beschriftungen für Layer in einem Kartendokument auf der Grundlage eines Polygonindex-Layers in Annotationen konvertiert.

import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.TiledLabelsToAnnotation_cartography("Map1", "Tiles", "data.gdb", 
                                          "GroupAnno", "Anno", "", "Tile_Scale",  
                                          "OID", "", "", "FEATURE_LINKED", 
                                          "GENERATE_UNPLACED_ANNOTATION")
TiledLabelsToAnnotation – Beispiel 2 (Workflowskript)

Das folgende Skript veranschaulicht einen Workflow mit den Funktionen MapServerCacheTilingSchemeToPolygons und TiledLabelsToAnnotation.

# Name: TiledLabelsToAnnotation_Example2.py
# Description: Create a tile feature class and use those tiles to create annotation.
# Requirements: ArcGIS Desktop Advanced license
# Import system modules
import arcpy
import os
# Set environment settings
arcpy.env.workspace = "C:/data/data.gdb"
# Set local variables
aprx = arcpy.mp.ArcGISProject(r"C:/data/Annotation.aprx")
inMap = aprx.listMaps("Map")[0]
inTilingScheme = os.path.join(
    arcpy.GetInstallInfo()['InstallDir'], 
    'Resources\\TilingSchemes\\ArcGIS_Online_Bing_Maps_Google_Maps.xml')
outFeatureClass = "C:/data/data.gdb/Tiles"
inTileExtent = "USE_MAP_EXTENT"
inClipping = "CLIP_TO_HORIZON"
inAntialiasing = "NONE"
inScales = ""
# Execute MapServerCacheTilingSchemeToPolygons
arcpy.MapServerCacheTilingSchemeToPolygons_cartography(
    inMap, inTilingScheme, outFeatureClass, inTileExtent, inClipping, 
    inAntialiasing, inScales)
# Set local variables
inPolygonIndexLayer = "Tiles"
inOutGeodatabase = "C:/data/data.gdb"
outOutLayer = "GroupAnno"
inAnnoSuffix = "Anno"
inRefScaleValue = ""
inRefScaleField = "Tile_Scale"
inTileIDField = "OID"
inCoordSysField = ""
inMapRotationField = ""
inFeatureLinked = "STANDARD"
inGenerateUnplaced = "GENERATE_UNPLACED_ANNOTATION"
# Execute TiledLabelsToAnnotation
arcpy.TiledLabelsToAnnotation_cartography(
    inMap, inPolygonIndexLayer, inOutGeodatabase, outOutLayer, inAnnoSuffix, 
    inRefScaleValue, inRefScaleField, inTileIDField, inCoordSysField, 
    inMapRotationField,inFeatureLinked, inGenerateUnplaced)

Umgebungen

Lizenzinformationen

  • ArcGIS Desktop Basic: Ja
  • ArcGIS Desktop Standard: Ja
  • ArcGIS Desktop Advanced: Ja

Verwandte Themen