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 la 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.

• Une annotation liée à une entité 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

Boîte de dialogue

Étiquette	Explication	Type 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. Current Display Extent (Étendue actuellement affichée)  : l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active. Dessiner l’étendue  : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Cette option crée une classe d’entités dans la géodatabase du projet et ajoute une couche à la carte. La classe d’entités possède le même système de coordonnées que la carte. Remarque : Cette option n’est pas disponible dans la boîte de dialogue Environnements. Elle est disponible uniquement dans un paramètre de l’outil correspondant à un type de données d’étendue ou dans l’onglet Environnements de la boîte de dialogue de l’outil. Remarque : Lorsque l’option de mise à jour Activer et désactiver la mise à jour de l’onglet Mettre à jour est activée, vous devez activer la mise à jour dans l’onglet du ruban Mettre à jour pour dessiner l’étendue. Extent of a Layer (Étendue d’une couche)  : l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option Extent of data in all layers (Étendue des données dans toutes les couches) pour obtenir l’étendue combinée de toutes les couches de carte actives, y compris le fond de carte. Cette option est uniquement disponible lorsqu’une carte avec des couches est active. Chaque couche de carte comporte les options suivantes : Toutes les entités  : étendue de toutes les entités dans la couche. Entités sélectionnées : étendue de toutes les entités sélectionnées dans la couche. Entités visibles  : étendue de toutes les entités visibles dans la couche. Remarque : Les étendues des options Entités sélectionnées  et Entités visibles  sont disponibles uniquement pour les couches d’entités. Browse (Parcourir)  : l’étendue repose sur un jeu de données existant. Intersection of Inputs (Intersection des entrées)  : l’étendue repose sur l’étendue minimale ou l’étendue d’intersection de toutes les entrées. S’il n’existe aucune intersection entre les entrées, il en résulte une étendue nulle avec uniquement des zéros. Union of Inputs (Union des entrées)  : l’étendue est basée sur l’étendue maximale ou combinée de toutes les entrées. Presse-papiers  : l’étendue peut être copiée depuis et vers le Presse-papiers. Copier l’étendue  : copie les coordonnées et le système de coordonnées de l’étendue dans le Presse-papiers. Coller l’étendue  : colle les coordonnées et, éventuellement, le système de coordonnées de l’étendue depuis le Presse-papiers. Si les valeurs du Presse-papiers n’incluent pas de système de coordonnées, l’étendue utilise celui de la carte. Remarque : Les coordonnées de l’étendue sont copiées vers et collées depuis le Presse-Papiers avec la même mise en forme et le même ordre que ceux de l’objet ArcPy Extent : X min, Y min, X max, Y max et la référence spatiale. Reset Extent (Réinitialiser l’étendue)  : la valeur par défaut de l’étendue est rétablie. Manually entered coordinates (Coordonnées saisies manuellement) : les coordonnées doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active. Attention : La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. L’utilisation d’une direction cardinale (N, S, E, O) n’est pas prise en charge. Utilisez le signe moins pour les coordonnées sud et ouest.	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 cette annotation est défini sur Non placée.	Boolean
Sélection du symbole dans la table (Facultatif)	Spécifie si toutes les propriétés du symbole textuel peuvent être mises à jour. 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)	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 est créée lorsque de nouvelles entités sont ajoutées à la classe d’entités liée et que le paramètre Créer des annotations liées aux entités 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 est mise à jour lorsque la forme de l’entité liée est modifiée et que le paramètre Créer des annotations liées aux entités 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 carte—Les étiquettes seront converties en annotations pour toutes les couches de la carte. Il s’agit de l’option par défaut. Couche unique—Les é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 qui est convertie lorsque le paramètre Convertir est défini sur 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 ayant des propriétés similaires sont combinées lors de la conversion en une classe d’entités unique. Désactivé : les classes d’étiquettes ayant des propriétés similaires ne sont pas combinées. Il s’agit de l’option par défaut.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Géodatabase mise à jour	Espace de travail dans lequel les classes d'entités en sortie sont enregistrées.	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})

Nom	Explication	Type 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 commune à 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_PLACED—Des annotations seront créées uniquement pour les entités étiquetées. Il s’agit de l’option par défaut. GENERATE_UNPLACED—Les annotations non placées sont stockées dans la classe d’entités annotations. Le champ d’état de cette annotation est défini sur Non placée.	Boolean
require_symbol_id (Facultatif)	Spécifie si toutes les propriétés du symbole textuel peuvent être mises à jour. NO_REQUIRE_ID—Toutes les propriétés du symbole textuel peuvent être mises à jour. Il s’agit de l’option par défaut. REQUIRE_ID—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
feature_linked (Facultatif)	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. STANDARD—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. FEATURE_LINKED—La 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 et que le paramètre feature_linked est défini sur FEATURE_LINKED. AUTO_CREATE—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. NO_AUTO_CREATE—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
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 modifiée et que le paramètre feature_linked est défini sur FEATURE_LINKED. SHAPE_UPDATE—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. NO_SHAPE_UPDATE—La 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_LAYERS—Les étiquettes seront converties en annotations pour toutes les couches de la carte. Il s’agit de l’option par défaut. SINGLE_LAYER—Les étiquettes seront converties en annotations pour une couche unique. La couche doit être précisée.	String
single_layer (Facultatif)	Couche contenant l’annotation qui est convertie 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_CLASS—Les étiquettes de toutes les couches seront converties en une classe d’entités annotations unique. FEATURE_CLASS_PER_FEATURE_LAYER—Les é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_CLASS—Les classes d’étiquettes ayant des propriétés similaires sont combinées lors de la conversion en une classe d’entités unique. NO_MERGE_LABEL_CLASS—Les classes d’étiquettes ayant des propriétés similaires ne sont pas combinées. Il s’agit de l’option par défaut.	Boolean

Sortie obtenue

Nom	Explication	Type 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 la fonction ConvertLabelsToAnnotation (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 (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')

Environnements

Mot-clé CONFIG en sortie, Longueur de champ de la chaîne du texte d’annotation

Informations de licence

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