Convertir les étiquettes en annotation (Cartographie)

Synthèse

Convertit les étiquettes en annotation pour une seule couche ou pour toute la carte. Des annotations standard et des annotations liées aux entités peuvent être créées.

Utilisation

  • Les étiquettes peuvent être converties en annotations pour une couche unique ou pour toute la carte. Si l’option de couche unique est choisie, la couche doit être spécifiée et se trouver sur la carte.

  • Les plages d'échelle des classes d'étiquettes sont respectées. Lorsque l'outil génère l'annotation pour une échelle de carte spécifique, il ne convertira que les classes d'étiquettes activées et visibles à cette échelle.

    Remarque :

    Les plages d’échelle des classes d’étiquettes sont définies dans l’onglet Étiquetage dans ArcGIS Pro.

  • Les classes d’entités annotations ne sont pas remplacées si un suffixe d’extension est spécifié. Dans ce cas, un nombre est ajouté au suffixe de classe d'entités annotations (par exemple, CitiesAnno, CitiesAnno_1, et ainsi de suite). Le format complet du nom est le suivant :

    <layer name> <duplicate feature class count> <anno suffix> <running number>

  • Si vous générez une annotation à diverses échelles de référence, créez votre carte pour chacune de ces échelles et évitez de définir une échelle de référence dans la carte. Vous pouvez ensuite convertir les étiquettes en annotation pour chaque échelle et attribuer des noms appropriés, par exemple, CitiesAnno_1000, CitiesAnno_100000.

  • Une sortie de cet outil est un groupe de couches. Dans la fenêtre Catalogue, la fenêtre Python ou un script Python autonome, vous pouvez utiliser l’outil Enregistrer dans un fichier de couche pour écrire le groupe de couches en sortie dans un fichier de couche. Lors de l’utilisation de ArcGIS Pro, l’outil ajoute le groupe de couches à l’affichage. Le groupe de couches créé est temporaire et disparaîtra à la fin de la session si le projet n'est pas enregistré.

  • Un groupe de couches existant sera remplacé si le même nom de couche est spécifié et si vous autorisez de manière explicite le remplacement de sorties.

  • Si le paramètre Create feature-linked annotation (Créer des annotations liées aux entités) n’est pas coché, le paramètre Convert labels from all layers to a single output feature class (Convertir les étiquettes de toutes les couches en une classe d’entités de sortie unique) peut être utilisé pour créer une classe d’entités annotations unique pour toute la carte.

    Lorsque vous créez une classe d’entités annotations unique pour la carte, les classes d’étiquettes ayant des propriétés similaires peuvent être combinées en une seule classe d’annotations à l’aide du paramètre Combiner les classes d’étiquettes similaires.

  • L'annotation qui est liée à des entités est associée à une entité spécifique dans une autre classe d'entités de la géodatabase. Si le paramètre Créer des annotations liées aux entités) est sélectionné, une classe de relations sera générée automatiquement lors de la création de la classe d’entités annotations.

  • Lorsque vous créez une annotation liée aux entités, l'espace de travail en sortie doit être le même que celui auquel les classes d'entités sont liées.

  • Si l’espace est insuffisant, certaines étiquettes peuvent ne pas s’afficher sur la carte. Pour convertir ces étiquettes, sélectionnez le paramètre Convertir les étiquettes non placées en annotations non placées. Ceci enregistre les étiquettes non placées dans la classe d'entités annotations, afin de vous permettre de les placer ultérieurement dans une session de mise à jour ArcGIS Pro.

  • Les espaces de travail memory et in_memory ne prennent pas en charge les annotations liées aux entités.

  • Cet outil respecte l’environnement Longueur du champ de chaîne de texte d’annotation. Lorsqu’il est défini, il remplace la longueur du champ définie par défaut dans le champ TextString dans n’importe quelle classe d’entités annotations créée dans une base de données.

Paramètres

ÉtiquetteExplicationType de données
Carte en entrée

Carte en entrée.

Map
Echelle de conversion

L’échelle à laquelle les étiquettes seront converties. Si une échelle de référence est définie sur la carte, cette échelle sera utilisée pour le dimensionnement des symboles et pour la création des classes d’entités annotations, mais la conversion s’effectuera à cette échelle.

Double
Géodatabase en sortie

Espace de travail dans lequel les classes d'entités en sortie sont enregistrées. L'espace de travail peut être une géodatabase existante ou un jeu de données d'entité existant. S’il ne s’agit pas de la même base de données que celle utilisée par toutes les couches dans la carte, l’option liée à une entité sera désactivée.

Workspace; Feature Dataset
Suffixe de l’annotation
(Facultatif)

Suffixe qui sera ajouté à chaque nouvelle classe d'entités annotations. Ce suffixe sera ajouté au nom de la classe d'entités source pour chaque nouvelle classe d'entités annotations.

String
Étendue
(Facultatif)

Spécifie l’étendue qui contient les étiquettes à convertir en annotation.

  • Default (Par défaut) : l’étendue repose sur l’étendue maximale de toutes les entrées participantes. Il s’agit de l’option par défaut.
  • Union of Inputs (Union des entrées) : l’étendue est basée sur l’étendue maximale de toutes les entrées.
  • Intersection of inputs (Intersection des entrées) : l’étendue est basée sur la surface minimale commune à toutes les entrées.
  • Current Display Extent (Étendue d’affichage actuelle) : l’étendue correspond à l’affichage visible. Cette option n’est pas disponible lorsque aucune carte n’est active.
  • As Specified Below (Comme spécifié ci-dessous) : l’étendue est basée sur les valeurs d’étendue minimale et maximale indiquées.
  • Browse (Parcourir) : l’étendue repose sur un jeu de données existant.
Extent
Convertir les étiquettes non placées en annotations non placées
(Facultatif)

Spécifie si des annotations non placées seront créées à partir des étiquettes non placées.

  • Désactivée - Des annotations seront créées uniquement pour les entités étiquetées. Il s’agit de l’option par défaut.
  • Activé : les annotations non placées sont stockées dans la classe d’entités annotations. Le champ d'état de ces annotations est défini sur Non placée.

Boolean
Sélection du symbole dans la table
(Facultatif)

Spécifie si les propriétés du symbole textuel qui peuvent être modifiées doivent être restreintes.

  • Désactivé : toutes les propriétés du symbole textuel peuvent être mises à jour. Il s’agit de l’option par défaut.
  • Activé : seules les propriétés des symboles qui activent les entités annotations peuvent être mises à jour afin de conserver la référence à leur symbole textuel associé dans la collection.

Boolean
Créer des annotations liées aux entités
(Facultatif)
Remarque :

Ce paramètre n’est disponible qu’avec les licences ArcGIS Desktop Standard et ArcGIS Desktop Advanced.

Indique si la classe d’entités annotations en sortie est liée ou non aux entités d’une autre classe d’entités.

  • Désactivé : la classe d'entités annotations en sortie n'est pas liée aux entités d'une autre classe d'entités. Il s’agit de l’option par défaut.
  • Activé : la classe d'entités annotations en sortie est liée aux entités d'une autre classe d'entités.

Boolean
Créer une annotation lors de l’ajout de nouvelles entités
(Facultatif)

Spécifie si une annotation sera créée lorsque de nouvelles entités sont ajoutées à la classe d’entités liée si le paramètre Create feature-linked annotation (Créer une annotation liée à une entité) est sélectionné.

  • Activé : une annotation liée aux entités sera générée lorsque de nouvelles entités sont ajoutées à la classe d’entités liée. Il s’agit de l’option par défaut.
  • Désactivé : une annotation liée aux entités ne sera pas générée lorsque de nouvelles entités sont ajoutées à la classe d’entités liée.

Boolean
Mettre à jour l’annotation lorsque la forme de l’entité est modifiée
(Facultatif)

Spécifie si la position de l’annotation sera mise à jour lorsque la forme de l’entité liée est mise à jour et que le paramètre Create feature-linked annotation (Créer une annotation liée à une entité) est sélectionné.

  • Activé : la position de l’annotation sera mise à jour lorsque la forme de l’entité liée est modifiée. Il s’agit de l’option par défaut.
  • Désactivé : la position de l’annotation ne sera pas mise à jour lorsque la forme de l’entité liée est modifiée.

Boolean
Couche en sortie
(Facultatif)

Groupe de couches qui contiendra l'annotation générée. Dans la fenêtre Catalog (Catalogue), vous pouvez utiliser l’outil Save To Layer File (Enregistrer dans un fichier de couche) pour enregistrer le groupe de couches en sortie dans un fichier de couche. Lorsque vous utilisez ArcGIS Pro quand une carte est ouverte, l'outil ajoute le groupe de couches à l'affichage si cette option est activée dans les options de géotraitement. Le groupe de couches créé est temporaire et disparaîtra à la fin de la session si le projet n'est pas enregistré.

Group Layer
Convertir
(Facultatif)

Spécifie si des annotations seront converties pour toutes les couches de la carte ou pour une couche unique. La couche unique doit être précisée.

  • Toutes les couches de la carteLes étiquettes seront converties en annotations pour toutes les couches de la carte. Il s’agit de l’option par défaut.
  • Couche uniqueLes étiquettes seront converties en annotations pour une couche unique. La couche doit être précisée.
String
Couche d’entités
(Facultatif)

Couche contenant l’annotation à convertir lorsque le paramètre Convert (Convertir) est défini sur Single layer (Couche unique). Cette couche doit se trouver sur la carte.

Feature Layer
Convertir les étiquettes de toutes les couches en une classe d’entités en sortie unique
(Facultatif)

Spécifie si les étiquettes seront converties en classes d’entités annotations individuelles ou en une classe d’entités annotations unique. En cas de conversion en une classe d’entités annotations unique, l’annotation ne peut pas être liée aux entités.

  • Activé : les étiquettes de toutes les couches seront converties en une classe d’entités annotations unique.
  • Désactivé : les étiquettes seront converties en classes d’entités annotations individuelles qui correspondent à leurs couches. Il s’agit de l’option par défaut.

Boolean
Combiner les classes d’étiquettes similaires
(Facultatif)

Spécifie si les classes d’étiquettes similaires seront fusionnées lorsque le paramètre Convert labels from all layers to a single output feature class (Convertir les étiquettes de toutes les couches en classe d’entités en sortie unique) est activé.

  • Activé : les classes d’étiquettes présentant des propriétés similaires seront fusionnées lorsque le paramètre Convert labels from all layers to a single output feature class (Convertir les étiquettes de toutes les couches en classe d’entités en sortie unique) est activé.
  • Désactivé : les classes d’étiquettes ne seront pas combinées si le paramètre Convert labels from all layers to a single output feature class (Convertir les étiquettes de toutes les couches en une classe d’entités en sortie unique) est activé. Il s’agit de l’option par défaut.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Géodatabase mise à jour

Espace de travail dans lequel les classes d'entités en sortie sont enregistrées.

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})
NomExplicationType de données
input_map

Carte en entrée.

Map
conversion_scale

L’échelle à laquelle les étiquettes seront converties. Si une échelle de référence est définie sur la carte, cette échelle sera utilisée pour le dimensionnement des symboles et pour la création des classes d’entités annotations, mais la conversion s’effectuera à cette échelle.

Double
output_geodatabase

Espace de travail dans lequel les classes d'entités en sortie sont enregistrées. L'espace de travail peut être une géodatabase existante ou un jeu de données d'entité existant. S’il ne s’agit pas de la même base de données que celle utilisée par toutes les couches dans la carte, l’option liée à une entité sera désactivée.

Workspace; Feature Dataset
anno_suffix
(Facultatif)

Suffixe qui sera ajouté à chaque nouvelle classe d'entités annotations. Ce suffixe sera ajouté au nom de la classe d'entités source pour chaque nouvelle classe d'entités annotations.

String
extent
(Facultatif)

Spécifie l’étendue qui contient les étiquettes à convertir en annotation.

  • MAXOF : l’étendue maximale de toutes les entrées est utilisée.
  • MINOF : l’étendue minimale de toutes les entrées est utilisée.
  • DISPLAY : l’étendue est égale à l’affichage visible.
  • Nom de la couche : l’étendue de la couche spécifiée est utilisée.
  • Objet Extent : l’étendue de l’objet spécifié est utilisée.
  • Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.

Si aucune valeur d’étendue n’est définie, l’étendue repose sur l’étendue maximale de toutes les entrées participantes. Il s’agit de l’option par défaut.

Extent
generate_unplaced
(Facultatif)

Spécifie si des annotations non placées seront créées à partir des étiquettes non placées.

  • ONLY_PLACEDDes annotations seront créées uniquement pour les entités étiquetées. Il s’agit de l’option par défaut.
  • GENERATE_UNPLACEDLes annotations non placées sont stockées dans la classe d’entités annotations. Le champ d'état de ces annotations est défini sur Non placée.
Boolean
require_symbol_id
(Facultatif)

Spécifie si les propriétés du symbole textuel qui peuvent être modifiées doivent être restreintes.

  • NO_REQUIRE_IDToutes les propriétés du symbole textuel peuvent être mises à jour. Il s’agit de l’option par défaut.
  • REQUIRE_IDSeules les propriétés des symboles qui activent les entités annotations peuvent être mises à jour afin de conserver la référence à leur symbole textuel associé dans la collection.
Boolean
feature_linked
(Facultatif)
Licence :

Ce paramètre n’est disponible qu’avec les licences ArcGIS Desktop Standard et ArcGIS Desktop Advanced.

Indique si la classe d’entités annotations en sortie est liée ou non aux entités d’une autre classe d’entités.

  • STANDARDLa classe d'entités annotations en sortie n'est pas liée aux entités d'une autre classe d'entités. Il s’agit de l’option par défaut.
  • FEATURE_LINKEDLa classe d'entités annotations en sortie est liée aux entités d'une autre classe d'entités.
Boolean
auto_create
(Facultatif)

Spécifie si une annotation est créée lorsque de nouvelles entités sont ajoutées à la classe d’entités liée si le paramètre feature_linked est défini sur FEATURE_LINKED.

  • AUTO_CREATEUne annotation liée aux entités sera générée lorsque de nouvelles entités sont ajoutées à la classe d’entités liée. Il s’agit de l’option par défaut.
  • NO_AUTO_CREATEUne annotation liée aux entités ne sera pas générée lorsque de nouvelles entités sont ajoutées à la classe d’entités liée.
Boolean
update_on_shape_change
(Facultatif)

Spécifie si la position de l’annotation est mise à jour lorsque la forme de l’entité liée est mise à jour et que le paramètre feature_linked est défini sur FEATURE_LINKED.

  • SHAPE_UPDATELa position de l’annotation sera mise à jour lorsque la forme de l’entité liée est modifiée. Il s’agit de l’option par défaut.
  • NO_SHAPE_UPDATELa position de l’annotation ne sera pas mise à jour lorsque la forme de l’entité liée est modifiée.
Boolean
output_group_layer
(Facultatif)

Groupe de couches qui contiendra l'annotation générée. Vous pouvez utiliser l'outil Enregistrer dans un fichier de couche pour enregistrer le groupe de couches en sortie dans un fichier de couche.

Group Layer
which_layers
(Facultatif)

Spécifie si des annotations seront converties pour toutes les couches de la carte ou pour une couche unique. La couche unique doit être précisée.

  • ALL_LAYERSLes étiquettes seront converties en annotations pour toutes les couches de la carte. Il s’agit de l’option par défaut.
  • SINGLE_LAYERLes étiquettes seront converties en annotations pour une couche unique. La couche doit être précisée.
String
single_layer
(Facultatif)

La couche contenant l’annotation à convertir lorsque le paramètre which_layers est défini sur SINGLE_LAYER. Cette couche doit se trouver sur la carte.

Feature Layer
multiple_feature_classes
(Facultatif)

Spécifie si les étiquettes seront converties en classes d’entités annotations individuelles ou en une classe d’entités annotations unique. En cas de conversion en une classe d’entités annotations unique, l’annotation ne peut pas être liée aux entités.

  • SINGLE_FEATURE_CLASSLes étiquettes de toutes les couches seront converties en une classe d’entités annotations unique.
  • FEATURE_CLASS_PER_FEATURE_LAYERLes étiquettes seront converties en classes d’entités annotations individuelles correspondant à chaque couche. Il s’agit de l’option par défaut.
Boolean
merge_label_classes
(Facultatif)

Spécifie si les classes d’étiquettes similaires sont fusionnées lorsque le paramètre multiple_feature_classes est défini sur SINGLE_FEATURE_CLASS.

  • MERGE_LABEL_CLASSLes classes d’étiquettes présentant des propriétés similaires sont fusionnées lorsque le paramètre multiple_feature_classes est défini sur SINGLE_FEATURE_CLASS.
  • NO_MERGE_LABEL_CLASSLes classes d’étiquettes ne sont pas fusionnées lorsque le paramètre multiple_feature_classes est défini sur SINGLE_FEATURE_CLASS. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
updated_geodatabase

Espace de travail dans lequel les classes d'entités en sortie sont enregistrées.

Workspace

Exemple de code

Exemple d’utilisation de l’outil Convertir les étiquettes en annotation (fenêtre Python)

Cet exemple Python pour la fonction ConvertLabelsToAnnotation convertit les étiquettes en annotation pour une seule couche de la carte.


import arcpy
arcpy.cartography.ConvertLabelsToAnnotation(
    'Map1', 10000, 'D:/data/Cobourg.gdb', 'Anno', 'MAXOF', 'ONLY_PLACED', 
    'REQUIRE_ID', 'STANDARD', '', '', 'AnnoLayer', 'SINGLE_LAYER', 'Schools', '', '')
Exemple 2 d’utilisation de l’outil Convertir les étiquettes en annotation  2 (script autonome)

Script autonome qui convertit des étiquettes en annotation pour la carte en utilisant la fonction ConvertLabelsToAnnotation. L’annotation sera convertie en une classe d’entités annotations unique et les classes d’étiquettes similaires seront fusionnées.

# 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')

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes