Esquema de ordenamiento en teselas de la caché del servidor de mapas a polígonos (Cartografía)

Resumen

Crea una nueva clase de entidad poligonal a partir de un esquema de ordenamiento en teselas existente.

Esta herramienta subdivide una extensión de mapa utilizando las mismas escalas que un esquema de ordenamiento en teselas de caché de servicio de mapas existente y crea teselas en un área grande o supertesela. Dado que la extensión de la supertesela es superior a la de las teselas reales definidas en el esquema, las teselas utilizadas como entrada en la herramienta Etiquetas en teselas a anotación pueden convertir etiquetas en anotación en un área más grande a la vez. Este proceso minimiza la duplicación de anotación a lo largo de las teselas.

Uso

  • Existen varias opciones para cargar un esquema de ordenamiento en teselas existente:

    • Cargar un esquema de ordenamiento en teselas desde un servicio de representación cartográfica on-line como ArcGIS Online, Google Maps, Bing Maps o Yahoo. Estos esquemas de ordenamiento en teselas se encuentran en el directorio de instalación de ArcGIS Pro, en la carpeta Resources\TilingSchemes.
    • Cargar un archivo de esquema de ordenamiento en teselas desde la caché de un servicio de mapas existente. Todas las memorias caché de mapas tienen un archivo de esquema de ordenamiento en teselas, conf.xml, en el directorio de caché (por ejemplo, C:\arcgisserver\arcgiscache\MyService\MyDataFrame\conf.xml).
    • Cree su propio archivo de esquema de ordenamiento en teselas mediante la herramienta Generar esquema de ordenamiento en teselas de caché de servidor de mapas.

  • La clase de entidad de salida de esta herramienta se puede utilizar como entrada en la herramienta Etiquetas en teselas a anotación.

  • En el parámetro Recortar teselas en el horizonte del sistema de coordenadas, el horizonte del sistema de coordenadas es el área de uso válida para un sistema de coordenadas proyectadas o geográficas particular.

Parámetros

EtiquetaExplicaciónTipo de datos
Mapa de entrada

El mapa actual que se usará.

Map
Esquema de ordenamiento en teselas

Un archivo .xml de esquema de ordenamiento en teselas predefinido.

File
Clase de entidad de salida

La clase de entidad poligonal de salida.

Feature Class
Generar polígonos que intersequen la extensión del mapa

Especifica si se crearán entidades poligonales para toda la extensión del esquema de ordenamiento en teselas o solo teselas que intersequen la extensión completa del mapa.

  • Activado: se crearán entidades poligonales para la extensión completa del mapa. Esta es la opción predeterminada.
  • Desactivado: se crearán entidades poligonales para la extensión completa del esquema de ordenamiento en teselas.
Boolean
Recortar teselas en el horizonte del sistema de coordenadas

Especifica si los polígonos se restringirán al área de uso válida para el sistema de coordenadas proyectadas o geográficas del mapa.

  • Activado: solo se crearán entidades poligonales dentro del área de uso válida para el sistema de coordenadas proyectadas o geográficas del mapa. Las teselas que estén dentro de la extensión del esquema de ordenamiento en teselas, pero fuera de la extensión del horizonte del sistema de coordenadas, se recortarán. Esta es la opción predeterminada.
  • Desactivado: se crearán entidades poligonales para la extensión completa del esquema de ordenamiento en teselas. Dentro de cada nivel de escala, los polígonos serán de un tamaño uniforme y no se recortarán en el horizonte del sistema de coordenadas. De este modo, puede que se creen datos que se encuentren fuera del área de uso válida para el sistema de coordenadas proyectadas o geográficas. Si una escala dentro del esquema de ordenamiento en teselas genera una tesela mayor que el dominio espacial de la clase de entidad, se crea una geometría nula para dicha entidad.
Boolean
Generar polígonos que coincidan con las memorias caché del servicio de mapas con anti-aliasing habilitado
(Opcional)

Especifica si se generarán polígonos que coincidan con las cachés del servicio de mapas con antialiasing habilitado. Una supertesela de caché de servicio de mapas tiene 2.048 x 2.048 píxeles con antialiasing, o 4.096 x 4.096 píxeles sin él. Para ver si se usó antialiasing en una caché existente, abra el archivo de esquema de ordenamiento en teselas, conf.xml, y compruebe si la etiqueta <Antialiasing> presenta el valor true.

  • Activado: se generarán teselas poligonales para coincidir con la extensión de supertesela de una caché de servicio de mapas con antialiasing habilitado.
  • Desactivado: se generarán teselas poligonales para coincidir con la extensión de supertesela de una caché de servicio de mapas sin antialiasing habilitado. Esta es la opción predeterminada.
Boolean
Escalas
(Opcional)

Los niveles de escala en los que se crearán los polígonos. Estos niveles de escala se rellenan automáticamente en función de los niveles de escala del esquema de ordenamiento en teselas de entrada. Puede crear polígonos para todos o solo algunos de los niveles de escala que se incluyen en su esquema de ordenamiento en teselas. No obstante, para agregar más niveles de escala debe modificar su archivo de esquema de ordenamiento en teselas o crear uno nuevo, ya que el botón Agregar valor no está disponible en esta herramienta.

Double

arcpy.cartography.MapServerCacheTilingSchemeToPolygons(input_map, tiling_scheme, output_feature_class, use_map_extent, clip_to_horizon, {antialiasing}, {levels})
NombreExplicaciónTipo de datos
input_map

El mapa actual que se usará.

Map
tiling_scheme

Un archivo .xml de esquema de ordenamiento en teselas predefinido.

File
output_feature_class

La clase de entidad poligonal de salida.

Feature Class
use_map_extent

Especifica si se crearán entidades poligonales para toda la extensión del esquema de ordenamiento en teselas o solo teselas que intersequen la extensión completa del mapa.

  • USE_MAP_EXTENTSe crearán entidades poligonales para la extensión completa del mapa. Esta es la opción predeterminada.
  • FULL_TILING_SCHEMESe crearán entidades poligonales para la extensión completa del esquema de ordenamiento en teselas.
Boolean
clip_to_horizon

Especifica si los polígonos se restringirán al área de uso válida para el sistema de coordenadas proyectadas o geográficas del mapa.

  • CLIP_TO_HORIZONSolo se crearán entidades poligonales dentro del área de uso válida para el sistema de coordenadas proyectadas o geográficas del mapa. Las teselas que estén dentro de la extensión del esquema de ordenamiento en teselas, pero fuera de la extensión del horizonte del sistema de coordenadas, se recortarán. Esta es la opción predeterminada.
  • UNIFORM_TILE_SIZESe crearán entidades poligonales para la extensión completa del esquema de ordenamiento en teselas. Dentro de cada nivel de escala, los polígonos serán de un tamaño uniforme y no se recortarán en el horizonte del sistema de coordenadas. De este modo, puede que se creen datos que se encuentren fuera del área de uso válida para el sistema de coordenadas proyectadas o geográficas. Si una escala dentro del esquema de ordenamiento en teselas genera una tesela mayor que el dominio espacial de la clase de entidad, se crea una geometría nula para dicha entidad.
Boolean
antialiasing
(Opcional)

Especifica si se generarán polígonos que coincidan con las cachés del servicio de mapas con antialiasing habilitado. Una supertesela de caché de servicio de mapas tiene 2.048 x 2.048 píxeles con antialiasing, o 4.096 x 4.096 píxeles sin él. Para ver si se usó antialiasing en una caché existente, abra el archivo de esquema de ordenamiento en teselas, conf.xml, y compruebe si la etiqueta <Antialiasing> presenta el valor true.

  • ANTIALIASINGSe generarán teselas poligonales para coincidir con la extensión de supertesela de una caché de servicio de mapas con antialiasing habilitado.
  • NONESe generarán teselas poligonales para coincidir con la extensión de supertesela de una caché de servicio de mapas sin antialiasing habilitado. Esta es la opción predeterminada.
Boolean
levels
[level,...]
(Opcional)

Los niveles de escala en los que se crearán los polígonos. Para crear polígonos para todos los niveles de escala incluidos en un esquema de ordenamiento en teselas, deje este parámetro en blanco. Puede crear polígonos para todos o solo algunos de los niveles de escala que se incluyen en su esquema de ordenamiento en teselas. No obstante, para agregar más niveles de escala debe modificar su archivo de esquema de ordenamiento en teselas o crear uno nuevo.

Double

Muestra de código

Ejemplo 1 de MapServerCacheTilingSchemeToPolygons (ventana de Python)

La siguiente secuencia de comandos independiente muestra cómo utilizar la función MapServerCacheTilingSchemeToPolygons.

import arcpy
import os

arcpy.env.workspace = "C:/data/data.gdb"
arcpy.MapServerCacheTilingSchemeToPolygons_cartography(
      "C:/data/Annotation.mxd", os.path.join(arcpy.GetInstallInfo()['InstallDir'], 
                                             'Resources\\TilingSchemes\\WGS84_Geographic_Coordinate_System_V2.xml'), 
      "Tiles", "USE_MAP_EXTENT", "CLIP_TO_HORIZON", "NONE")
Ejemplo 2 de MapServerCacheTilingSchemeToPolygons (script de flujo de trabajo)

El siguiente script muestra un flujo de trabajo con las funciones MapServerCacheTilingSchemeToPolygons y TiledLabelsToAnnotation.

# Name: MapServerCacheTilingSchemeToPolygons_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"
# Change path below to match your system
inTilingScheme = os.path.join(arcpy.GetInstallInfo()['InstallDir'], 
                              'Resources\\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, inTilingScheme, outFeatureClass, 
    inTileExtent, inClipping, inAntialiasing, inScales)

# Set local variables
inMapDocument = "C:/data/Annotation.mxd"
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, inPolygonIndexLayer, inOutGeodatabase, 
    outOutLayer, inAnnoSuffix, inRefScaleValue, inRefScaleField, 
    inTileIDField, inCoordSysField, inMapRotationField,inFeatureLinked, 
    inGenerateUnplaced)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados