Convertir etiquetas en anotación (Cartografía)

Resumen

Convierte las etiquetas de una sola capa o de todo el mapa en anotaciones. Tanto la anotación estándar como la vinculada a entidad se pueden crear de este modo.

Uso

• Es posible convertir etiquetas en anotación para una sola capa o para todo el mapa. Si se selecciona la opción de una sola capa, es necesario especificar la capa, y debe estar en el mapa.

• Se respetarán los rangos de escala de la clase de etiqueta. Cuando la herramienta genere una anotación para una escala de mapa específica, solo convertirá las clases de etiqueta que estén activadas y visibles en esa escala.

  Nota:

  Los rangos de escala de la clase de etiqueta se establecen en la pestaña Etiquetado en ArcGIS Pro.

• Las clases de entidad de anotación no se sobrescribirán si se especifica un sufijo existente. En este caso, se agregará un número al sufijo de la clase de entidad de anotación (por ejemplo, CitiesAnno, CitiesAnno_1, etc.). El formato completo para asignar nombre es el siguiente:

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

• Si está produciendo anotaciones en varias escalas de referencia, diseñe el mapa para cada una de esas escalas y evite establecer una escala de referencia en el mapa. A continuación, puede convertir las etiquetas en anotación para cada escala y asignarles un nombre apropiado, por ejemplo, CitiesAnno_1000, CitiesAnno_100000, etc.

• Una de las salidas de esta herramienta es una capa de grupo. Si trabaja en el panel Catálogo, la ventana de Python o un script independiente de Python, puede utilizar la herramienta Guardar en archivo de capa para escribir la capa del grupo de salida en un archivo de capa. Si utiliza ArcGIS Pro, la herramienta agrega la capa de grupo a la visualización. El grupo de capas que se crea es temporal y, una vez finalizada la sesión, no permanece en el sistema a menos que se guarde el proyecto.

• Un grupo de capas existente se sobrescribirá si especifica el mismo nombre de capa y si especifica explícitamente que está permitida la sobrescritura de la salida.

• Si el parámetro Crear anotación vinculada a entidad no se activa, se puede utilizar el parámetro Convertir etiquetas de todas las capas a una sola clase de entidad de salida para crear una única clase de entidad de anotación para todo el mapa.

  Al crear una única clase de entidad de anotación para el mapa, es posible fusionar las clases de etiqueta con propiedades similares en una clase de anotación con el parámetro Fusionar clases de etiqueta similares.

• La anotación vinculada a entidad se asocia a una entidad específica en otra clase de entidad en la geodatabase. Si el parámetro Crear anotación vinculada a entidad está activado, se generará automáticamente una clase de relación al crear la clase de entidad de anotación de salida.

• Cuando se crean anotaciones vinculadas a una entidad, el espacio de trabajo de salida debe ser el mismo que el de las clases de entidad a las que están vinculadas.

• Algunas etiquetas quizá no aparezcan en el mapa porque no hay espacio. Para convertir estas etiquetas, active el parámetro Convertir etiquetas no colocadas en anotaciones no localizadas. De este modo, se guardan las etiquetas no colocadas en la clase de entidad de anotación, lo que le permite posicionarlas después en una sesión de edición de ArcGIS Pro.

• Ni el espacio de trabajo Memory ni el in_memory admiten la anotación vinculada a las entidades.

• Esta herramienta respeta el entorno Longitud del campo de cadena de texto de anotación. Cuando esté establecido, invalidará la longitud de campo predeterminada en el campo TextString de cualquier clase de entidad de anotación creada en una base de datos.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Mapa de entrada	El mapa de entrada.	Map
Escala de conversión	La escala a la que se convertirán las etiquetas. Si se ha establecido una escala de referencia en el mapa, esta se utilizará para el cambio de tamaño de los símbolos y la creación de la clase de entidad de anotación, pero la conversión se producirá a esta escala.	Double
Geodatabase de salida	El espacio de trabajo donde se guardan las clases de entidad de salida. El espacio de trabajo puede ser una geodatabase o un dataset de entidades existente. Si esta no es la misma base de datos utilizada por todas las capas del mapa, la opción vinculada a entidad estará deshabilitada.	Workspace; Feature Dataset
Sufijo de anotación (Opcional)	El sufijo que se agrega a cada clase de entidad de anotación nueva. Este sufijo se incorpora al nombre de la clase de entidad de origen para cada clase de entidad de anotación nueva.	String
Extensión (Opcional)	Especifica la extensión que contiene las etiquetas que se convertirán en anotación. Extensión de visualización actual : la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo. Extensión de dibujo : la extensión se basará en un rectángulo dibujado en el mapa o la escena. Esta opción creará una clase de entidad en la geodatabase del proyecto y agregará una capa al mapa. La clase de entidad tendrá el mismo sistema de coordenadas que el mapa. Nota: Esta opción no está disponible en el cuadro de diálogo Entornos. Solo está disponible desde un parámetro de herramienta con un tipo de datos de extensión o desde la pestaña Entornos de un cuadro de diálogo de herramienta. Nota: Cuando la opción de edición Habilitar y deshabilitar edición en la pestaña Editar está activada, es preciso habilitar la edición en la pestaña Editar de la cinta para dibujar la extensión. Extensión de mapa : la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción Extensión de datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas. Cada capa de mapas tiene las opciones siguientes: Todas las entidades : extensión de todas las entidades en una capa. Entidades seleccionadas: extensión de las entidades seleccionadas en la capa. Entidades visibles : extensión de las entidades visibles en la capa. Nota: Las extensiones de las opciones Entidades seleccionadas y Entidades visibles solo están disponibles para capas de entidades. Examinar : la extensión se basará en un dataset existente. Intersección de entradas : la extensión se basará en la extensión mínima o en común de todas las entradas. Si ninguna de las entradas se solapa, podría generarse una extensión nula con todos los valores igual a cero. Combinación de entradas : la extensión se basa en la extensión máxima o combinada de todas las entradas. Portapapeles : la extensión puede copiarse en y desde el portapapeles. Copiar extensión : copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles. Pegar extensión : pega las coordenadas de la extensión y, si se desea, el sistema de coordenadas desde el portapapeles. Si los valores del portapapeles no incluyen un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa. Nota: Las coordenadas de la extensión se copian del portapapeles y se pegan con el mismo formato y orden que el objeto Extent de ArcPy: x-min, y-min, x-max, y-max y referencia espacial. Restablecer extensión : la extensión se restablecerá al valor predeterminado. Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo. Precaución: El mapa podría utilizar unidades de visualización distintas de las coordenadas introducidas. No se admite el uso de una dirección cardinal (N, S, E, O). Utilice un valor de signo negativo para las coordenadas sur y oeste.	Extent
Convertir etiquetas no colocadas en anotaciones no colocadas (Opcional)	Especifica si se creará una anotación no colocada a partir de etiquetas no colocadas. Desactivado: la anotación solo se crea para las entidades que estén etiquetadas. Esta es la opción predeterminada. Activado: las anotaciones no colocadas se almacenan en la clase de entidad de anotación. El campo de estado de esta anotación se establece como No colocada.	Boolean
Se requieren símbolos para seleccionarlos desde la tabla de símbolos (Opcional)	Especifica si se pueden editar las propiedades de un símbolo de texto. Desactivado: se pueden editar todas las propiedades de un símbolo de texto. Esta es la opción predeterminada. Activado: solo se pueden editar las propiedades de símbolo que permitan a las entidades de anotación mantener la referencia a su símbolo de texto asociado en la colección.	Boolean
Crear anotación vinculada a entidades (Opcional)	Especifica si la clase de entidad de anotación de salida se vinculará a las entidades en otra clase de entidad. Desactivado: la clase de entidad de anotación de salida no se vinculará a las entidades en otra clase de entidad. Esta es la opción predeterminada. Activado: la clase de entidad de anotación de salida se vinculará a las entidades en otra clase de entidad.	Boolean
Crear anotación cuando se agreguen nuevas entidades (Opcional)	Especifica si se creará una anotación cuando se agreguen nuevas entidades a la clase de entidad vinculada y se activa el parámetro Crear anotación vinculada a entidad. Activado: la anotación vinculada a entidad se creará cuando se agreguen nuevas entidades a la clase de entidad vinculada. Esta es la opción predeterminada. Desactivada: la anotación vinculada a entidad no se creará cuando se agregan nuevas entidades a la clase de entidad vinculada.	Boolean
Actualizar anotación cuando se modifique forma de entidad (Opcional)	Especifica si se actualizará la posición de la anotación cuando la forma de la entidad vinculada se modifica y el parámetro Crear anotación vinculada a entidad está activado. Activado: la posición de la anotación se actualizará cuando se modifique la forma de la entidad vinculada. Esta es la opción predeterminada. Desactivado: la posición de la anotación no se actualizará cuando se modifique la forma de la entidad vinculada.	Boolean
Capa de salida (Opcional)	El grupo de capas que contiene la anotación generada. Cuando esté trabajando en el panel Catálogo, puede usar la herramienta Guardar en archivo de capas para escribir la capa de grupo de salida en un archivo de capas. Cuando utiliza ArcGIS Pro con un mapa abierto, la herramienta agrega la capa de grupo a la visualización si esta opción está activada en las opciones de geoprocesamiento. El grupo de capas que se crea es temporal y, una vez finalizada la sesión, no permanece en el sistema a menos que se guarde el proyecto.	Group Layer
Convertir (Opcional)	Especifica si la anotación se convertirá para todas las capas del mapa o solo para una. Es necesario especificar la capa única. Todas las capas del mapa—Las etiquetas se convertirán en anotación para todas las capas del mapa. Esta es la opción predeterminada. Una sola capa—Las etiquetas se convertirán en anotación en una sola capa. Es necesario especificar la capa.	String
Capa de entidades (Opcional)	La capa con la anotación que se convertirá cuando el parámetro Convert se establezca en Una sola capa. Esta capa debe estar presente en el mapa.	Feature Layer
Convertir etiquetas de todas las capas a una sola clase de entidad de salida (Opcional)	Especifica si las etiquetas se convertirán a clases de entidad de anotación individuales o a una sola clase de entidad de anotación. Si se convierte a una sola clase de entidad de anotación, la anotación no se puede vincular a una entidad. Activado: las etiquetas de todas las capas se convertirán a una sola clase de entidad de anotación. Desactivado: las etiquetas se convertirán a clases de entidad de anotación individuales que se corresponden con sus capas. Esta es la opción predeterminada.	Boolean
Fusionar clases de etiqueta similares (Opcional)	Especifica si las clases de etiqueta similares se fusionarán cuando el parámetro Convertir etiquetas de todas las capas a una sola clase de entidad de salida esté activado. Activado: las clases de etiqueta con propiedades similares se fusionarán al convertir a una sola clase de entidad. Desactivado: las clases de etiqueta con propiedades similares no se fusionarán. Esta es la opción predeterminada.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Geodatabase actualizada	El espacio de trabajo donde se guardan las clases de entidad de salida.	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})

Nombre	Explicación	Tipo de datos
input_map	El mapa de entrada.	Map
conversion_scale	La escala a la que se convertirán las etiquetas. Si se ha establecido una escala de referencia en el mapa, esta se utilizará para el cambio de tamaño de los símbolos y la creación de la clase de entidad de anotación, pero la conversión se producirá a esta escala.	Double
output_geodatabase	El espacio de trabajo donde se guardan las clases de entidad de salida. El espacio de trabajo puede ser una geodatabase o un dataset de entidades existente. Si esta no es la misma base de datos utilizada por todas las capas del mapa, la opción vinculada a entidad estará deshabilitada.	Workspace; Feature Dataset
anno_suffix (Opcional)	El sufijo que se agrega a cada clase de entidad de anotación nueva. Este sufijo se incorpora al nombre de la clase de entidad de origen para cada clase de entidad de anotación nueva.	String
extent (Opcional)	Especifica la extensión que contiene las etiquetas que se convertirán en anotación. MAXOF: se usará la extensión máxima de todas las entradas. MINOF: se usará el área mínima común a todas las entradas. DISPLAY: la extensión es igual a la visualización visible. Nombre de capa: se utilizará la extensión de la capa especificada. Objeto de Extent: se utilizará la extensión del objeto especificado. Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max. Si no se proporciona ningún valor de extensión, la extensión se basará en la extensión máxima de todas las entradas participantes. Esta es la opción predeterminada.	Extent
generate_unplaced (Opcional)	Especifica si se creará una anotación no colocada a partir de etiquetas no colocadas. ONLY_PLACED—La anotación sólo se crea para las entidades que estén etiquetadas. Esta es la opción predeterminada. GENERATE_UNPLACED—Las anotaciones no colocadas se almacenan en la clase de entidad de anotación. El campo de estado de esta anotación se establece como No colocada.	Boolean
require_symbol_id (Opcional)	Especifica si se pueden editar las propiedades de un símbolo de texto. NO_REQUIRE_ID—Se pueden editar todas las propiedades de un símbolo de texto. Esta es la opción predeterminada. REQUIRE_ID—Solo se pueden editar las propiedades de símbolo que permitan a las entidades de anotación mantener la referencia a su símbolo de texto asociado en la colección.	Boolean
feature_linked (Opcional)	Especifica si la clase de entidad de anotación de salida se vinculará a las entidades en otra clase de entidad. STANDARD—La clase de entidad de anotación de salida no se vinculará a las entidades en otra clase de entidad. Esta es la opción predeterminada. FEATURE_LINKED—La clase de entidad de anotación de salida se vinculará a las entidades en otra clase de entidad.	Boolean
auto_create (Opcional)	Especifica si la anotación se creará cuando se agreguen nuevas entidades a la clase de entidad vinculada con el parámetro feature_linked establecido en FEATURE_LINKED. AUTO_CREATE—La anotación vinculada a entidad se creará cuando se agreguen nuevas entidades a la clase de entidad vinculada. Esta es la opción predeterminada. NO_AUTO_CREATE—La anotación vinculada a entidad no se creará cuando se agregan nuevas entidades a la clase de entidad vinculada.	Boolean
update_on_shape_change (Opcional)	Especifica si se actualizará la posición de la anotación cuando la forma de la entidad vinculada se modifica con el parámetro feature_linked establecido en FEATURE_LINKED. SHAPE_UPDATE—La posición de la anotación se actualizará cuando se modifique la forma de la entidad vinculada. Esta es la opción predeterminada. NO_SHAPE_UPDATE—La posición de la anotación no se actualizará cuando se modifique la forma de la entidad vinculada.	Boolean
output_group_layer (Opcional)	El grupo de capas que contiene la anotación generada. Puede usar la herramienta Guardar en archivo de capa para escribir el grupo de capas de salida en un archivo de capa.	Group Layer
which_layers (Opcional)	Especifica si la anotación se convertirá para todas las capas del mapa o solo para una. Es necesario especificar la capa única. ALL_LAYERS—Las etiquetas se convertirán en anotación para todas las capas del mapa. Esta es la opción predeterminada. SINGLE_LAYER—Las etiquetas se convertirán en anotación en una sola capa. Es necesario especificar la capa.	String
single_layer (Opcional)	La capa con la anotación que se convertirá si se cambia el valor del parámetro which_layers a SINGLE_LAYER. Esta capa debe estar presente en el mapa.	Feature Layer
multiple_feature_classes (Opcional)	Especifica si las etiquetas se convertirán a clases de entidad de anotación individuales o a una sola clase de entidad de anotación. Si se convierte a una sola clase de entidad de anotación, la anotación no se puede vincular a una entidad. SINGLE_FEATURE_CLASS—Las etiquetas de todas las capas se convertirán a una sola clase de entidad de anotación. FEATURE_CLASS_PER_FEATURE_LAYER—Las etiquetas se convertirán a clases de entidad de anotación individuales que se corresponden con sus capas. Esta es la opción predeterminada.	Boolean
merge_label_classes (Opcional)	Especifica si las clases de etiqueta similares se fusionarán cuando el parámetro multiple_feature_classes se defina como SINGLE_FEATURE_CLASS. MERGE_LABEL_CLASS—Las clases de etiqueta con propiedades similares se fusionarán al convertir a una sola clase de entidad. NO_MERGE_LABEL_CLASS—Las clases de etiqueta con propiedades similares no se fusionarán. Esta es la opción predeterminada.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
updated_geodatabase	El espacio de trabajo donde se guardan las clases de entidad de salida.	Workspace

Muestra de código

Ejemplo de ConvertLabelsToAnnotation (ventana de Python)

Esta muestra de Python de la función ConvertLabelsToAnnotation convierte etiquetas en anotación para una sola capa del mapa.

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

Ejemplo 2 de ConvertLabelsToAnnotation (script independiente)

Este script independiente convierte etiquetas en anotación para el mapa mediante la función ConvertLabelsToAnnotation. La anotación se convertirá en una sola clase de entidad de anotación y las clases de etiqueta similares se fusionarán.

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

Entornos

Palabra clave CONFIG de salida, Longitud del campo TextString de anotación

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí