Convertir etiquetas en gráficos (Cartografía)

Resumen

Convierte las etiquetas de una sola capa o de todo el mapa en gráficos.

Uso

• Es posible convertir etiquetas en gráficos 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 un gráfico 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.

• El formato para la denominación de las capas gráficas es <layer name><graphics layer suffix>.

  Los nombres de las capas gráficas duplicadas no se sobrescriben.

• Una de las salidas de esta herramienta es una capa de grupo. Puede usar la herramienta Guardar en archivo de capa para escribir la capa de grupo de salida en un archivo de capa. Si utiliza la herramienta en 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.

• Una capa de grupo existente se sobrescribirá si se especifica el mismo nombre de capa y se activa la opción Permitir que las herramientas de geoprocesamiento sobrescriban los datasets existentes en las opciones de geoprocesamiento.

• El parámetro Convertir las etiquetas de todas las capas en una sola capa de gráficos de salida permite crear una sola capa de gráficos para todo el mapa.

• Algunas etiquetas quizá no aparezcan en el mapa porque no hay espacio. Active la casilla de verificación del parámetro Convertir etiquetas no colocadas en gráficos, para guardar las etiquetas no colocadas en la capa de gráficos, lo que permite hacerlas visibles y posicionarlas más tarde.

Sintaxis

arcpy.cartography.ConvertLabelsToGraphics(input_map, conversion_scale, {which_layers}, {single_layer}, {graphics_suffix}, {extent}, {multiple_graphics_layers}, {generate_unplaced}, {output_group_layer})

Parámetro	Explicación	Tipo de datos
input_map	El objeto de mapa de entrada.	Map
conversion_scale	La escala a la que se van a convertir 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 capa de gráficos, pero la conversión se producirá a esta escala.	Double
which_layers (Opcional)	Especifica si se convertirán los gráficos para todas las capas del mapa o solo para una. ALL_LAYERS —Las etiquetas se convierten en gráficos para todas las capas del mapa. Esta es la opción predeterminada. SINGLE_LAYER —Las etiquetas se convierten en gráficos en una sola capa. La capa se debe especificar en el parámetro Capa de entidades (single_layer en Python).	String
single_layer (Opcional)	La capa que contiene las etiquetas que hay que convertir cuando el parámetro which_layers se define como SINGLE_LAYER. Esta capa debe estar presente en el mapa.	Feature Layer
graphics_suffix (Opcional)	El sufijo que se agrega a cada nueva capa de gráficos. Este sufijo se incorpora al nombre de la clase de entidad de origen para nueva capa de gráficos.	String
extent (Opcional)	Especifica la extensión que contiene las etiquetas que se convertirán en gráficos. MAXOF: se utilizará la extensión máxima de todas las entradas. MINOF: se utilizará el área mínima en común de todas las entradas. DISPLAY: la extensión es igual a la visualización actual. 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.	Extent
multiple_graphics_layers (Opcional)	Especifica si las etiquetas se convertirán en capas de gráficos individuales o una sola capa de gráficos. SINGLE_GRAPHICS_LAYER —Las etiquetas de todas las capas se convertirán en una sola capa de gráficos. GRAPHICS_LAYER_PER_FEATURE_LAYER —Las etiquetas se convertirán en capas de gráficos individuales que se corresponden con sus capas. Esta es la opción predeterminada.	Boolean
generate_unplaced (Opcional)	Especifica si se crearán gráficos a partir de las etiquetas no colocadas. ONLY_PLACED —Solo se crean gráficos para las entidades que estén etiquetadas. Esta es la opción predeterminada. GENERATE_UNPLACED —Los gráficos no colocados se almacenan en la capa de gráficos con su visibilidad desactivada.	Boolean
output_group_layer (Opcional)	La capa de grupo que contiene los gráficos generados. Puede usar la herramienta Guardar en archivo de capa para escribir el grupo de capas de salida en un archivo de capa.	Group Layer

Muestra de código

Ejemplo de ConvertLabelsToGraphics (ventana de Python)

Ejemplo de Python de la función ConvertLabelsToGraphics que convierte etiquetas en gráficos para una sola capa del mapa.

import arcpy
arcpy.cartography.ConvertLabelsToGraphics(
    'Map1', 10000, 'SINGLE_LAYER', 'Schools', 'Graphics', 'MAXOF', 
    'GRAPHICS_LAYER_PER_FEATURE_LAYER', 'ONLY_PLACED', 'GroupGraphics')

Ejemplo 2 de ConvertLabelsToGraphics (script independiente)

Script independiente que convierte etiquetas en gráficos para el mapa mediante la función ConvertLabelsToGraphics.

# Name: ConvertLabelsToGraphics.py
# Description: Find all the maps in the project and
#              convert labels to graphics for each map
# import system modules
import arcpy
# Loop through the project, find all the maps, and
#   convert labels to graphics for each map,
#   using the name of the map as part of the graphics layer suffix 
project = arcpy.mp.ArcGISProject("D:\\data\\myproject.aprx")
for mp in project.listMaps():
    print("Converting labels to graphics for: " + mp.name)
    arcpy.cartography.ConvertLabelsToGraphics(
            mp, 10000, 'ALL_LAYERS', '', 'Graphics_' + mp.name, 'MAXOF', 
            'GRAPHICS_LAYER_PER_FEATURE_LAYER', 'ONLY_PLACED',  
            'GraphicsLayers_' + mp.name)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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