Administrar caché de teselas (Administración de datos)

Resumen

Crea una caché de teselas o actualiza las teselas de una caché de teselas existente. Puede utilizar esta herramienta para crear teselas, reemplazar teselas faltantes, sobrescribir teselas desactualizadas y eliminar teselas.

Uso

• Al crear una caché de teselas con esta herramienta, si no se especificó un valor para el parámetro Área de interés, la caché se crea con la extensión completa del ráster o dataset de mosaico de origen o la extensión actual del archivo de mapa.

• La extensión de la caché generada puede ser mayor que el valor del parámetro Área de interés. En este caso, la herramienta divide los datos en áreas grandes, conocidas como superteselas, antes de recortarlas en teselas del tamaño que se especifique. Si el valor del parámetro Fuente de datos de entrada se utiliza el antialiasing, la supertesela es de 2.048 x 2.048 píxeles; de lo contrario, es de 4.096 x 4.096. Si la entidad del Área de interés especificada interseca el límite de una supertesela, se creará toda la supertesela. Esto significa que puede que tenga que acercarla antes de que el almacenamiento en caché por clase de entidad pueda tener un efecto al ahorrar tiempo o espacio en disco. Si tiene varias áreas de interés que cubren la mayor parte del valor del parámetro Fuente de datos de entrada, es posible que no obtenga mucho beneficio del almacenamiento en caché por clase de entidad, porque la mayoría de sus entidades intersecarán una supertesela.

• Para crear una caché en un esquema de ordenamiento en teselas personalizado, asegúrese de que cuenta con un esquema de ordenamiento en teselas definido para el dataset de origen antes de utilizar esta herramienta. Puede usar la herramienta Generar esquema de ordenamiento en teselas de caché de teselas para crear el esquema de ordenamiento en teselas.

• Para crear una caché en un esquema de ordenamiento en teselas de ArcGIS Online, especifique Esquema de ArcGIS Online para el parámetro Esquema de ordenamiento en teselas de entrada.

• Esta herramienta puede tardar un tiempo considerable en ejecutarse para las cachés que cubren una extensión geográfica grande o escalas muy grandes. Si la herramienta se cancela, la creación de teselas se detiene, pero las teselas existentes no se eliminan. Significa que se puede cancelar la herramienta en cualquier momento y, si se vuelve a ejecutar más tarde en la misma caché y se especifica Volver a crear teselas vacías para el parámetro Administrar modo, continúa en el punto en el que se detuvo.

• Esta herramienta admite el parámetro de entorno Procesamiento en paralelo.

• Si se activa el parámetro Formato listo para servir, el contenido de la caché se genera utilizando la especificación del paquete de teselas abierto. El formato de la caché es Compact V2, pero el esquema de la caché se almacena en JSON en lugar de XML. Para obtener más información acerca del formato listo para servir, consulte Publicar una capa de teselas desde un dataset de caché.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ubicación de caché	La carpeta en la que se crea el dataset de la caché, la capa ráster o la ruta a una caché de teselas existente.	Folder; Raster Layer
Administrar modo	Especifica el modo que se utilizará para administrar la caché. Volver a crear todas las teselas—Las teselas existentes se reemplazarán y se agregarán teselas nuevas si la extensión cambió o si las capas se agregaron a una caché multicapas. Volver a crear teselas vacías—Solo se crearán teselas que estén vacías. Las teselas existentes se dejarán sin cambios. Eliminar teselas—Las teselas se eliminarán de la caché. La estructura de la carpeta de caché no se eliminará.	String
Nombre de caché (Opcional)	El nombre del dataset de caché que se crea en la ubicación de la caché.	String
Fuente de datos de entrada (Opcional)	Un dataset ráster, un dataset de mosaico o un archivo de mapa. Este parámetro no es necesario si el parámetro Administrar modo se ha definido como Eliminar teselas. Un archivo de mapa (.mapx) no puede contener un servicio de mapas ni un servicio de imágenes.	Mosaic Layer; Raster Layer; Map
Esquema de ordenamiento en teselas de entrada (Opcional)	Especifica el esquema de ordenamiento en teselas que se utilizará. Esquema de ArcGIS Online—Se utilizará el esquema de ordenamiento en teselas de ArcGIS Online predeterminado. Importar esquema—Se importará y utilizará un esquema de ordenamiento en teselas existente. Esquema de ordenamiento en teselas de elevación—Se utilizará el esquema de ordenamiento en teselas de servicios de elevación. Esquema de ordenamiento en teselas WGS84 versión 2—Se utilizará el esquema de ordenamiento en teselas WGS84 versión 2. Esquema de ordenamiento en teselas de elevación WGS84 versión 2—Se utilizará el esquema de ordenamiento en teselas WGS84 versión 2 para crear una caché de teselas para los datos de elevación.	String
Importar esquema de ordenamiento en teselas (Opcional)	La ruta de acceso a un archivo de esquema existente (.xml) o un esquema de ordenamiento en teselas importado desde un servicio de mapas o un servicio de imágenes existente.	Image Service; Map Server; File
Escalas [Tamaño de píxel] (Espacio en disco estimado) (Opcional)	Los niveles de escala en los que se crearán o eliminarán las teselas, en función del valor del parámetro Administrar modo. El tamaño de píxel se basa en la referencia espacial del esquema de ordenamiento en teselas. De forma predeterminada, solo se utilizarán los valores para Escala mínima almacenada en caché y Escala máxima almacenada en caché. La alteración del valor de los parámetros Escala de caché mínima o Escala de caché máxima producirá la activación o desactivación de los valores de escala apropiados. Las escalas activadas que no estén dentro del rango de los valores de los parámetros Escala mínima almacenada en caché o Escala máxima almacenada en caché se ignorarán al generar la caché.	Double
Área de interés (Opcional)	Un área de interés que se utiliza para restringir dónde se van a crear o eliminar las teselas. Puede ser una clase de entidad o puede ser un conjunto de entidades que se defina de forma interactiva. Este parámetro es útil si desea administrar teselas para áreas con formas irregulares. También es útil en situaciones donde desea almacenar previamente en caché algunas áreas y dejar sin almacenar en caché las áreas menos visitadas.	Feature Set
Tamaño máximo de celda original (Opcional)	El valor que define la visibilidad de la fuente de datos para la que se generará la caché. De manera predeterminada, el valor está vacío. Si el valor está vacío, se aplica lo siguiente: Para los niveles de caché que se encuentran dentro de los rangos visibles de la fuente de datos, la caché se genera a partir de la fuente de datos. Para los niveles de caché que se encuentran fuera de la visibilidad de la fuente de datos, la caché se generará a partir del nivel de caché anterior. Si el valor es mayor que cero, se aplicará lo siguiente: Para los niveles con tamaños de celda menores o iguales que el valor de este parámetro, la caché se genera a partir de la fuente de datos. Para los niveles con tamaños de celda mayores que el valor de este parámetro, la caché se genera a partir del nivel de caché anterior. La unidad de medida del valor de este parámetro debe ser la misma que la unidad de medida del tamaño de celda del dataset de origen.	Double
Escala de caché mínima (Opcional)	La escala mínima a la que se crearán teselas. Este valor no necesita ser la escala más pequeña del esquema de ordenamiento en teselas. La escala mínima de memoria caché determinará las escalas que se usan al generar la memoria caché.	Double
Escala en caché máxima (Opcional)	La escala máxima a la que se crearán teselas. No es necesario que este valor sea la escala más grande en el esquema de ordenamiento en teselas. La escala máxima determinará las escalas que se usarán al generar la caché.	Double
Formato Listo para servir (Opcional)	Especifica si el contenido de la caché se genera utilizando la especificación del paquete de teselas abierto y también especifica el formato de archivo del esquema de la caché. Activado: el contenido de la caché se genera utilizando la especificación del paquete de teselas abierto. Los paquetes de teselas pueden empaquetarse en un archivo zip como paquete de teselas para flujos de trabajo sin conexión. El formato de la caché es Compact V2 y el esquema de la caché se almacena en formato JSON. Desactivado: el contenido de la caché se genera utilizando un esquema almacenado en formato XML. Esta es la opción predeterminada.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Nombre de caché	El dataset de caché que se creará en la ubicación de la caché de salida.	Raster Dataset

Python

arcpy.management.ManageTileCache(in_cache_location, manage_mode, {in_cache_name}, {in_datasource}, {tiling_scheme}, {import_tiling_scheme}, {scales}, {area_of_interest}, {max_cell_size}, {min_cached_scale}, {max_cached_scale}, {ready_to_serve_format})

Nombre	Explicación	Tipo de datos
in_cache_location	La carpeta en la que se crea el dataset de la caché, la capa ráster o la ruta a una caché de teselas existente.	Folder; Raster Layer
manage_mode	Especifica el modo que se utilizará para administrar la caché. RECREATE_ALL_TILES—Las teselas existentes se reemplazarán y se agregarán teselas nuevas si la extensión cambió o si las capas se agregaron a una caché multicapas. RECREATE_EMPTY_TILES—Solo se crearán teselas que estén vacías. Las teselas existentes se dejarán sin cambios. DELETE_TILES—Las teselas se eliminarán de la caché. La estructura de la carpeta de caché no se eliminará.	String
in_cache_name (Opcional)	El nombre del dataset de caché que se crea en la ubicación de la caché.	String
in_datasource (Opcional)	Un dataset ráster, un dataset de mosaico o un archivo de mapa. Este parámetro es obligatorio si el parámetro manage_mode se define como DELETE_TILES. Un archivo de mapa (.mapx) no puede contener un servicio de mapas ni un servicio de imágenes.	Mosaic Layer; Raster Layer; Map
tiling_scheme (Opcional)	Especifica el esquema de ordenamiento en teselas que se utilizará. ARCGISONLINE_SCHEME—Se utilizará el esquema de ordenamiento en teselas de ArcGIS Online predeterminado. IMPORT_SCHEME—Se importará y utilizará un esquema de ordenamiento en teselas existente. ARCGISONLINE_ELEVATION_SCHEME—Se utilizará el esquema de ordenamiento en teselas de servicios de elevación. WGS84_V2_SCHEME—Se utilizará el esquema de ordenamiento en teselas WGS84 versión 2. WGS84_V2_ELEVATION_SCHEME—Se utilizará el esquema de ordenamiento en teselas WGS84 versión 2 para crear una caché de teselas para los datos de elevación.	String
import_tiling_scheme (Opcional)	La ruta de acceso a un archivo de esquema existente (.xml) o un esquema de ordenamiento en teselas importado desde un servicio de mapas o un servicio de imágenes existente.	Image Service; Map Server; File
scales [scale,...] (Opcional)	Los niveles de escala en los que se crearán o eliminarán las teselas, en función del valor del parámetro manage_mode. El tamaño de píxel se basa en la referencia espacial del esquema de ordenamiento en teselas. De forma predeterminada, solo se usarán los valores para min_cached_scale y max_cached_scale al generar la caché. La alteración del valor de los parámetros min_cached_scale o max_cached_scale cambiará las escalas que se vayan a usar al generar la caché. Las escalas que existen, pero no están dentro del rango de los valores de los parámetros min_cached_scale o max_cached_scale, se ignorarán al generar la caché.	Double
area_of_interest (Opcional)	Un área de interés que se utiliza para restringir dónde se van a crear o eliminar las teselas. Puede ser una clase de entidad o puede ser un conjunto de entidades que se defina de forma interactiva. Este parámetro es útil si desea administrar teselas para áreas con formas irregulares. También es útil en situaciones donde desea almacenar previamente en caché algunas áreas y dejar sin almacenar en caché las áreas menos visitadas.	Feature Set
max_cell_size (Opcional)	El valor que define la visibilidad de la fuente de datos para la que se generará la caché. De manera predeterminada, el valor está vacío. Si el valor está vacío, se aplica lo siguiente: Para los niveles de caché que se encuentran dentro de los rangos visibles de la fuente de datos, la caché se genera a partir de la fuente de datos. Para los niveles de caché que se encuentran fuera de la visibilidad de la fuente de datos, la caché se generará a partir del nivel de caché anterior. Si el valor es mayor que cero, se aplicará lo siguiente: Para los niveles con tamaños de celda menores o iguales que el valor de este parámetro, la caché se genera a partir de la fuente de datos. Para los niveles con tamaños de celda mayores que el valor de este parámetro, la caché se genera a partir del nivel de caché anterior. La unidad de medida del valor de este parámetro debe ser la misma que la unidad de medida del tamaño de celda del dataset de origen.	Double
min_cached_scale (Opcional)	La escala mínima a la que se crearán teselas. Este valor no necesita ser la escala más pequeña del esquema de ordenamiento en teselas. La escala mínima de memoria caché determinará las escalas que se usan al generar la memoria caché.	Double
max_cached_scale (Opcional)	La escala máxima a la que se crearán teselas. No es necesario que este valor sea la escala más grande en el esquema de ordenamiento en teselas. La escala máxima determinará las escalas que se usarán al generar la caché.	Double
ready_to_serve_format (Opcional)	Especifica si el contenido de la caché se genera utilizando la especificación del paquete de teselas abierto y también especifica el formato de archivo del esquema de la caché. READY_TO_SERVE_FORMAT—El contenido de la caché se genera utilizando la especificación del paquete de teselas abierto (https://github.com/Esri/tile-package-spec). Los paquetes de teselas pueden empaquetarse en un archivo zip como paquete de teselas para flujos de trabajo sin conexión. El formato de la caché es Compact V2 y el esquema de la caché se almacena en formato JSON. NON_READY_TO_SERVE_FORMAT—El contenido de la caché se genera utilizando un esquema almacenado en formato XML. Esta es la opción predeterminada.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
out_cache_location	El dataset de caché que se creará en la ubicación de la caché de salida.	Raster Dataset

Muestra de código

Ejemplo 1 de ManageTileCache (ventana de Python)

Esta es una muestra de Python para la función ManageTileCache.

import arcpy
            
arcpy.ManageTileCache_management(
      "C:/CacheDatasets/Manage", "RECREATE_ALL_TILES", "Test",
      "C:/Data/Cache.gdb/Md", "IMPORT_SCHEME", "C:/Data/Cache.gdb/Md",
      "#", "#", "#", "40000", "2000", "NON_READY_TO_SERVE_FORMAT")

Ejemplo 2 de ManageTileCache (script independiente)

Esta es una muestra de script de Python para la función ManageTileCache.

#Generate tile cache for 3 out of 5 levels defined in tiling scheme

import arcpy

folder = "C:/Workspace/CacheDatasets/Manage"
mode = "RECREATE_ALL_TILES"
cacheName = "Test"
dataSource = "C:/Workspace/Cache.gdb/md"
method = "IMPORT_SCHEME"
tilingScheme = "C:/Workspace/Schemes/Tilingscheme.xml"
scales = "16000;8000;4000;2000;1000"
areaofinterest = "#"
maxcellsize = "#"
mincachedscale = "8000"
maxcachedscale = "2000"
ready_to_serve_format="NON_READY_TO_SERVE_FORMAT"

arcpy.ManageTileCache_management(
       folder, mode, cacheName, dataSource, method, tilingScheme,
       scales, areaofinterest, maxcellsize, mincachedscale, maxcachedscale, ready_to_serve_format)

Entornos

Factor de procesamiento en paralelo

Casos especiales

Factor de procesamiento en paralelo

Si el valor del factor de procesamiento en paralelo está vacío (en blanco), la herramienta se ejecutará con un valor predeterminado del 50% (la mitad) de los núcleos disponibles.

Información de licenciamiento

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