Etiquetado en teselas vectoriales

Cuando se crean teselas vectoriales, las etiquetas habilitadas en las capas del mapa se incluyen en las teselas. Sin embargo, las capacidades de etiquetado de las teselas vectoriales incluyen solo un subconjunto de las disponibles en ArcGIS Pro. Las propiedades de etiquetado de ArcGIS Pro se convierten cuando es posible en las propiedades correspondientes en la especificación de la tesela vectorial. ArcGIS Pro admite dos motores de etiquetado, pero el Motor de etiquetado Maplex da como resultado más propiedades convertidas, como se especifica a continuación.

Clases de etiquetas

Una o más clases de etiquetas se pueden convertir a teselas vectoriales. Las capacidades de colocación de los clientes de teselas vectoriales son limitadas en comparación con los motores de etiquetado de ArcGIS Pro. Por ejemplo, si dos clases de etiquetas para una capa de puntos colocan etiquetas con una posición preferida en la parte superior derecha de la etiqueta, los motores de etiquetado de ArcGIS Pro mueven las etiquetas para que aparezcan ambas.

Con las teselas vectoriales, los clientes colocan solo la etiqueta de la clase de prioridad más alta en la posición especificada y dejan la otra porque está en conflicto. Por lo tanto, se recomienda que las entidades con más de una clase de etiqueta tengan posiciones de etiqueta distintas para evitar conflictos y minimizar las etiquetas eliminadas. En muchos casos, el texto apilado también puede satisfacer las necesidades de más de una clase de etiqueta. Consulte la sección Apilado de etiqueta que aparece a continuación para obtener más información.

Símbolo de texto

El símbolo de texto se convierte a las propiedades del símbolo correspondiente en la especificación de la tesela vectorial. Los tamaños de fuente se convierten de puntos a píxeles. Las fuentes se convierten en representaciones optimizadas en los recursos de la tesela vectorial y las llamadas se convierten en sprites. Para los símbolos de texto que usan el tamaño de etiqueta basado en escala, se crean paradas para la propiedad "text-size". Si el tamaño de las etiquetas está limitado a un rango de tamaño, la propiedad "text-size" se aplica con paradas para obtener variaciones en el tamaño en función de los valores.

A continuación se muestra un ejemplo de símbolos de texto:

"layout": {
  "text-font": ["Tahoma Bold"],
  "text-size": {
  "stops": [[5, 13.3333], [15, 48]]
  }
}

Las propiedades de símbolo de texto Color de símbolo de halo y Tamaño de halo se convierten a "text-halo-color" y "text-halo-size". Las propiedades de símbolo de texto Ancho de contorno de símbolo de halo y Ancho de contorno de símbolo de halo no son compatibles con la especificación de la tesela vectorial y se ignoran.

El texto especificado como minúsculas o todo en mayúsculas se aplica al texto de la etiqueta de la entidad. El espaciado entre letras se convierte a "text-letter-spacing" con las unidades convertidas a ems. Las líneas directrices no son compatibles con las teselas vectoriales. Los tipos de llamada con líneas directrices solo tienen representado el símbolo de fondo. Por ejemplo, una llamada de tipo globo tiene el color y el contorno especificados, pero no una línea directriz.

El texto vertical especificado como de derecha a izquierda con la propiedad Progresión de bloques se convierte en modo de escritura de texto con vertical como su valor. Esta propiedad se utiliza para la colocación vertical de texto asiático. Solo las etiquetas que contienen al menos un carácter de un rango que admita la escritura vertical (por ejemplo, caracteres CJK) se pueden colocar verticalmente.

Las siguientes propiedades de símbolo de texto no se admiten en la creación de teselas vectoriales:

  • Propiedades de símbolo de texto como el color del contorno, ancho del contorno, subrayado, tachado, cambio de mayúsculas o minúsculas del texto para versalitas, ajuste de posición, alineación horizontal, alineación vertical y sombra
  • Propiedades de formato de símbolo de texto como el espaciado de palabras, ancho de letra, espaciado de línea, invertir ángulo, ligaduras, kerning, dibujar glifos como geometría, extrapolar líneas base, sugerencias de glifo y modo de compatibilidad
  • Propiedades de párrafo de símbolo de texto como guiones suaves, sangría de primera línea, sangría antes y sangría después
  • Propiedades de internacionalización de símbolo de texto como la dirección del texto, orientación del glifo, idioma regional y codificación de la fuente

Expresiones de etiqueta

Las expresiones de etiqueta simples de una sola línea o avanzadas en Arcade, VBScript, JScript y Python son compatibles con las teselas vectoriales. También se admiten las consultas SQL utilizadas para etiquetar un subconjunto de entidades en función de un valor de campo. Las expresiones de etiqueta se procesan y almacenan como un valor de propiedad en las teselas vectoriales con el nombre de propiedad de "_name". Si se está etiquetando más de una clase de etiqueta, el nombre de la propiedad contendrá un número correspondiente al orden de la clase de etiqueta "_name1", "_name2", y así sucesivamente.

Las etiquetas de formato de etiquetas no son compatibles y se eliminan del texto de la etiqueta en las teselas vectoriales.

Apilado de etiqueta

Las etiquetas de Maplex se pueden configurar para apilarse dinámicamente según los caracteres presentes en la etiqueta y el espacio disponible en el mapa. Alternativamente, las etiquetas de Maplex se pueden configurar para forzar el apilado en función de la presencia de caracteres específicos. Las teselas vectoriales no admiten el apilado dinámico, pero sí admiten el apilado forzado. El proceso de creación de la tesela vectorial aplica un apilado forzado al texto escrito en la propiedad de nombre de la entidad que se está etiquetando.

Abreviatura de etiqueta

Las etiquetas de Maplex se pueden configurar para abreviarse dinámicamente según el texto de la etiqueta y el espacio disponible en el mapa. Como alternativa, las entradas del diccionario de abreviaturas Maplex que utilizan la opción Traducir se aplican independientemente del espacio. Las teselas vectoriales no admiten abreviaturas dinámicas, pero sí admiten abreviaturas de traducción. El proceso de creación de la tesela vectorial aplica abreviaturas de traducción al texto escrito en la propiedad de nombre de la entidad que se está etiquetando.

Ubicación de etiquetas

Están disponibles las siguientes opciones de ubicación de etiqueta:

Ubicación de punto

La creación de la tesela vectorial establece la posición de la etiqueta, "text-anchor", según la posición predeterminada especificada en las propiedades de ubicación de la etiqueta. Si se usa un estilo de ubicación fijo en Maplex o en el motor de etiquetado estándar, la ubicación coincide. Si se usa un estilo de ubicación "Best Position", la posición clasificada más alta se especifica como ubicación en las teselas vectoriales. La etiqueta se desplaza de la entidad mediante la propiedad "text-offset", que tiene en cuenta el tamaño del símbolo y el desplazamiento especificado en la ubicación de la etiqueta. Si se aplica rotación al texto, se establece el valor de rotación para la propiedad "text-rotate". Si el texto se rota utilizando un campo o expresión de rotación, se establece el campo de rotación más cualquier rotación adicional para la propiedad "text-rotate". Si la configuración de etiquetas del mapa está configurada para rotar las etiquetas cuando se rota el mapa, esta configuración se respeta para las etiquetas de puntos utilizando la propiedad "text-rotation-alignment" establecida en"map" y la propiedad "text-keep-upright" establecida en false.

El siguiente es un ejemplo que muestra las propiedades de etiquetado de una capa de puntos para el texto ubicado directamente sobre un punto (anclaje en la parte inferior):

"id": "U.S. Cities",
"type": "symbol",
"source": "esri",
"source-layer": "U.S. Cities",
"layout": {
  "icon-image": "U.S. Cities",
  "icon-allow-overlap": true,
  "text-font": ["Tahoma Regular"],
  "text-size": 13.3333,
  "text-anchor": "bottom",
  "text-offset": [0, 0.065],
  "text-field": "{_name}",
  "text-optional": true
  }

Ubicación de línea

En las etiquetas de línea de las teselas vectoriales solo es posible la colocación curvada regular y la colocación horizontal centrada. Todos los demás estilos de ubicación de línea se convierten en ubicación curvada regular. Las ubicaciones de etiquetas de desplazamiento de las líneas se convierten a teselas vectoriales si el desplazamiento se limita a un solo lado de la línea. Para mover el texto al lado correcto se aplica un valor de desplazamiento. Tenga en cuenta que las etiquetas curvadas normalmente se colocan como texto recto si el segmento es recto. El proceso de creación de la tesela vectorial crea geometrías de línea secundarias para suavizar la colocación curvada. Se crean geometrías de puntos secundarias para la colocación horizontal centrada.

El siguiente es un ejemplo de ubicación de línea en la línea:

"id": "U.S. National Transportation Atlas Interstate Highways/label/Class 1",
"type": "symbol",
"source": "esri",
"source-layer": "U.S. National Transportation Atlas Interstate Highways/label",
"layout": {
  "symbol-placement": "line",
  "symbol-spacing": 1000,
  "text-font": ["Tahoma Regular"],
  "text-size": 13.3333,
  "text-field": "{_name}",
  "text-optional": true
 }

Ubicación del polígono

Se admiten las ubicaciones curvadas, horizontales, rectas y de ríos. La ubicación de río da como resultado la misma ubicación que la curvada. El proceso de creación de la tesela vectorial crea geometrías secundarias para etiquetar, si es necesario que coincidan con el estilo de ubicación solicitado. Por ejemplo, las opciones de colocación de etiquetas como Recta en polígono y Curvada en polígono hacen que se cree una geometría de puntos o líneas para ubicar y orientar las etiquetas correctamente dentro de cada polígono. Si la configuración de etiquetas del mapa está configurada para rotar etiquetas cuando se rota el mapa, esta configuración se respeta para las etiquetas de polígono con la propiedad de estilo "text-rotation-alignment" establecida en "mapa" y la propiedad "text-keep-upright" establecida en false.

Para la ubicación básica en el centro de un polígono, no se especifican propiedades de posición, como en el siguiente ejemplo:

"id": "U.S. Counties (Generalized)/label/Class 1",
"type": "symbol",
"source": "esri",
"source-layer": "U.S. Counties (Generalized)/label",
"layout": {
  "text-font": ["Tahoma Regular"],
  "text-size": 13.3333,
  "text-field": "{_name}",
  "text-optional": true
}

Resolución de conflictos

La ubicación de etiqueta de Maplex tiene una variedad de configuraciones de resolución de conflictos, pero solo dos son compatibles con las teselas vectoriales.

Para etiquetas de línea, Repetir > Intervalo mínimo se convierte a la propiedad "symbol-spacing" con las unidades en píxeles. Etiquetas no ubicadas > No quitar nunca, que permite etiquetas superpuestas cuando está habilitada, se convierte a la propiedad "text-allow-overlap" con el valor true.

Temas relacionados