Resumen
Convierte etiquetas en anotación para capas de un mapa basado en una capa de índice de polígono.
La herramienta divide un mapa en teselas y crea una anotación para cada tesela a la vez. Esto resulta útil para convertir una gran cantidad de etiquetas a anotación. La capa de índice de polígono puede generarse con las herramientas Esquema de ordenamiento en teselas del caché del servidor de mapas a polígonos o Entidades de índice de cuadrícula o cualquier otra clase de entidad poligonal que cubra el área donde desea crear la anotación.
Uso
Se respetarán los rangos de escala de la clase de etiqueta. Cuando la herramienta genere una anotación para una escala de referencia específica, solo convertirá las clases de etiqueta que estén activadas y visibles en esa escala.
Si selecciona teselas antes de ejecutar la herramienta, sólo se creará una anotación para las teselas seleccionadas.
Para actualizar la anotación sólo para algunas teselas en la capa de índice de polígono, primero seleccione las entidades de anotación con ese valor TileID específico y elimínelas. Después, seleccione las entidades poligonales y vuelva a ejecutar la herramienta.
Una de las salidas de esta herramienta es una serie de capas de grupo. Una capa de grupo contendrá una capa de grupo para cada escala de referencia para la que se creó una anotación.
Al trabajar en ArcCatalog o ModelBuilder, puede usar la herramienta Guardar en archivo de capa para escribir la capa de grupo de salida en un archivo de capa. Cuando utiliza ArcMap, la herramienta agrega la capa de grupo a la visualización si la opción está seleccionada en las opciones de geoprocesamiento. La capa de grupo que se crea es temporal y, una vez finalizada la sesión, no permanece en el sistema a menos que se guarde el documento.
Las capas de grupo creadas en ArcCatalog no se pueden utilizar en ArcMap, a menos que se guarden en un archivo de capa usando la herramienta Guardar en archivo de capa.
Una capa de grupo existente se sobrescribirá si se especifica el mismo nombre de capa y si especifica explícitamente que está permitida la sobreescritura de las salidas.
Si se encuentran nombres de clase de entidad duplicados en el marco de datos, se agregará un número a la anotación después del nombre de la clase de entidad (por ejemplo, Cities01Anno10000, Cities02Anno10000, etc.).
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, CitiesAnno10000, CitiesAnno10000_1, etc.).
La escala de referencia para las clases de entidad de anotación se puede especificar de las dos maneras siguientes:
- La primera opción es utilizar un campo de la capa de índice de polígono para determinar la escala de referencia de las clases de entidad de anotación de salida. Use esta opción si desea crear anotaciones para varios niveles de escalas.
- La segunda opción es especificar explícitamente un valor de escala de referencia. Todas las clases de entidad de anotación utilizarán esta escala de referencia. Si hay una escala de referencia establecida en el documento de mapa, será el valor predeterminado de entrada para la herramienta. Cuando utiliza ArcMap, si no hay una escala de referencia establecida, la escala actual será el valor predeterminado.
Si está utilizando una capa de índice de polígono creada con la herramienta Esquema de ordenamiento en teselas del caché del servidor de mapas a polígonos, use el campo Tile_Scale para el parámetro Campo de escala de referencia. Se creará una clase de entidad de anotación para cada combinación de capa-Tile_Scale.
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.
Si se proporciona un campo de sistema de coordenadas de la capa de índice de polígono, la anotación para cada tesela se proyectará en ese sistema de coordenadas para cumplir con los objetivos de dibujo y ubicación.
La anotación vinculada a una entidad está asociada a una entidad específica en otra clase de entidad de la geodatabase. Al crear la clase de entidad de anotación vinculada a entidad, también se generará automáticamente una clase de relación.
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.
Es posible que algunas etiquetas no se visualicen en el mapa debido a que no hay espacio para ellas. Para convertir estas etiquetas, active la casilla Generar anotación no colocada. 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.
Sintaxis
arcpy.cartography.TiledLabelsToAnnotation(map_document, data_frame, 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})
Parámetro | Explicación | Tipo de datos |
map_document | El documento de mapa de origen que contiene las etiquetas que se convertirán a anotación. | ArcMap Document |
data_frame | El marco de datos del documento de mapa que contiene las etiquetas que se convertirán a anotación. | String |
polygon_index_layer | La capa de polígono que contiene entidades de tesela. | Table View |
out_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. | Workspace; Feature Dataset |
out_layer | El grupo de capas que contiene la anotación generada. Al trabajar en ArcCatalog, puede usar la herramienta Guardar en archivo de capa para escribir la capa de grupo de salida en un archivo de capa. Cuando utiliza ArcMap, la herramienta agrega la capa de grupo a la visualización si la opción está seleccionada en las opciones de geoprocesamiento. La capa de grupo que se crea es temporal y, una vez finalizada la sesión, no permanece en el sistema a menos que se guarde el documento. | Group Layer |
anno_suffix | 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. La escala de referencia para la anotación aparece a continuación de este sufijo. | String |
reference_scale_value (Opcional) | El valor de escala que se usará como referencia para la anotación. Es la escala en la que se basarán todos los tamaños de texto y símbolos de la anotación. | Double |
reference_scale_field (Opcional) | El campo en la capa de índice de polígono que determina la escala de referencia de la anotación. Es la escala en la que se basarán todos los tamaños de texto y símbolos de la anotación. | Field |
tile_id_field (Opcional) | Un campo en la capa de índice de polígono que identifica de manera única el área con teselas. Estos valores completarán el campo TileID en la tabla de atributos de la clase de entidad de anotación. | Field |
coordinate_sys_field (Opcional) | Un campo en la capa de índice de polígono que contiene la información del sistema de coordenadas para cada tesela. Debido a la longitud necesaria para almacenar la información del sistema de coordenadas en un campo, la capa de índice de polígono que contiene el campo de sistema de coordenadas debe ser una clase de entidad de geodatabase. | Field |
map_rotation_field (Opcional) | Un campo de la capa de índice de polígono que contiene el ángulo con el que se rotará el marco de datos. | Field |
feature_linked (Opcional) | Especifica si la clase de entidad de anotación de salida se vinculará a las entidades en otra clase de entidad.
| Boolean |
generate_unplaced_annotation (Opcional) | Especifica si se creará una anotación no colocada a partir de etiquetas no colocadas.
| Boolean |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_workspace | El espacio de trabajo donde se guardan las clases de entidad de salida. | Workspace; Feature Dataset |
Muestra de código
Ejemplo de TiledLabelsToAnnotation (ventana de Python)
Muestra de Python para la función TiledLabelsToAnnotation que convierte etiquetas en una anotación para capas en un documento de mapa basado en una capa de índice de polígono.
import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.TiledLabelsToAnnotation_cartography("Annotation.mxd", "Layers",
"data.gdb", "GroupAnno", "Anno", "",
"Tile_Scale", "OID", "", "",
"FEATURE_LINKED",
"GENERATE_UNPLACED_ANNOTATION")
Ejemplo 2 de TiledLabelsToAnnotation (script de flujo de trabajo)
El siguiente script muestra un flujo de trabajo con las funciones MapServerCacheTilingSchemeToPolygons y 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
inMapDocument = "C:/data/Annotation.mxd"
inDataFrame = "Layers"
inTilingScheme = os.path.join(
arcpy.GetInstallInfo()['InstallDir'],
"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(
inMapDocument, inDataFrame, inTilingScheme, outFeatureClass, inTileExtent,
inClipping, inAntialiasing, inScales)
# Set local variables
inMapDocument = "C:/data/Annotation.mxd"
inDataFrame = "Layers"
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(
inMapDocument, inDataFrame, inPolygonIndexLayer, inOutGeodatabase,
outOutLayer, inAnnoSuffix, inRefScaleValue, inRefScaleField, inTileIDField,
inCoordSysField, inMapRotationField,inFeatureLinked, inGenerateUnplaced)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí