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
El valor del parámetro Fuente de datos de entrada puede ser un mapa; sin embargo, el documento no puede contener un servicio de mapas ni un servicio de imágenes.
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 la extensión actual del documento de mapa.
La extensión de la caché generada puede ser mayor que el valor del parámetro Área de interés. De ser este el caso, la herramienta divide los datos en áreas grandes, conocidas como superteselas, antes de recortarlas en teselas del tamaño que especificó. 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 ARCGISONLINE_SCHEME 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. Esto 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 RECREATE_EMPTY_TILES para el parámetro Administrar modo, continuará la ejecución a partir del punto en el que se detuvo.
Esta herramienta admite el parámetro de entorno Procesamiento en paralelo.
Sintaxis
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})
Parámetro | 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é.
| String |
in_cache_name (Opcional) | El nombre del dataset de caché que se creará en la ubicación de la caché. | String |
in_datasource (Opcional) | Un dataset ráster, un dataset de mosaico o un documento de mapa. Este parámetro no se necesita cuando se especifica DELETE_TILES en el parámetro manage_mode. Un documento de ArcMap (.mxd) no puede contener un servicio de mapas ni un servicio de imágenes. | ArcMap Document; Mosaic Layer; Raster Layer |
tiling_scheme (Opcional) | Especifica el esquema de ordenamiento en teselas que se utilizará.
| 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.
| Double |
area_of_interest (Opcional) | Define un área de interés 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:
Si el valor es mayor que cero, se aplicará lo siguiente:
La unidad del valor de Tamaño máximo de celda de origen debe ser la misma que la unidad 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 tiene por qué 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 tiene por qué ser la escala más grande del esquema de ordenamiento en teselas. La escala máxima determinará las escalas que se usarán al generar la caché. | Double |
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 herramienta 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")
Ejemplo 2 de ManageTileCache (script independiente)
Esta es una muestra de script de Python para la herramienta 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"
arcpy.ManageTileCache_management(
folder, mode, cacheName, dataSource, method, tilingScheme,
scales, areaofinterest, maxcellsize, mincachedscale, maxcachedscale)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí