Export Tile Cache (Data Management)

Summary

Exports tiles from an existing tile cache to a new tile cache or a tile package. The tiles can either be independently imported into other caches or they can be accessed from ArcGIS for Desktop or mobile devices as a raster dataset.

Usage

• When exporting a tile cache as a tile package, the cache storage format is always COMPACT.

• This tool supports the Parallel Processing environment setting.

Syntax

ExportTileCache_management (in_cache_source, in_target_cache_folder, in_target_cache_name, {export_cache_type}, {storage_format_type}, {scales}, {area_of_interest})

Parameter	Explanation	Data Type
in_cache_source	An existing tile cache to be exported.	Raster Layer; Raster Dataset
in_target_cache_folder	The output folder into which the tile cache or tile package will be exported.	Folder
in_target_cache_name	The name of the exported tile cache or tile package.	String
export_cache_type (Optional)	Choose to export cache as a tile cache or a tile package. Tile packages are suitable for ArcGIS Runtime and ArcGIS Mobile deployments. TILE_CACHE —A stand-alone cache raster dataset. This is the default. TILE_PACKAGE —A single compressed file (.tpk) where the cache dataset is added as a layer and consolidated so that it can be shared easily. Usable in ArcMap as well as in ArcGIS Runtime and ArcGIS Mobile applications.	String
storage_format_type (Optional)	Determines the storage format of tiles. The default storage format is COMPACT. COMPACT —Group tiles into large files called bundles. This storage format is more efficient in terms of storage and mobility. This is the default. EXPLODED —Each tile is stored as an individual file.Note that this format cannot be used with tile packages.	String
scales [scale,...] (Optional)	A list of scale levels at which tiles will be exported.	Double
area_of_interest (Optional)	An area of interest that spatially constrains where tiles are exported from the cache. It can be a feature class, or it can be a feature that you interactively define in ArcMap. This parameter is useful if you want to export irregularly shaped areas, as the tool clips the cache dataset at pixel resolution.	Feature Set

Code Sample

ExportTileCache example 1 (Python window)

This is a Python sample for the ExportTileCache tool.

import arcpy

arcpy.ExportTileCache_management(
     "C:/Data/CacheDatasets/Source", "C:/Data/CacheDatasets", 
     "Target", "TILE_PACKAGE", "COMPACT", "4000;2000;1000", "#")

ExportTileCache example 2 (stand-alone script)

This is a Python script sample for the ExportTileCache tool.

#Export tile cache for some levels to an EXPLODED format in 
#another location

import arcpy

    
cacheSource = "C:/Data/CacheDatasets/Source"
cacheTarget = "C:/Data/CacheDatasets"
cacheName = "Target"
cacheType = "TILE_CACHE"
storageFormat = "EXPLODED"
scales = "4000;2000;1000"
areaofinterest = "#"

arcpy.ExportTileCache_management(cacheSource, cacheTarget, cacheName,
     cacheType, storageFormat, scales, areaofinterest)

Environments

Parallel Processing Factor

Parallel Processing Factor

If the Parallel Processing Factor value is empty (blank), the tool will run with a default value of 50 percent (one-half) of the available cores.

Licensing Information

ArcGIS for Desktop Basic: Yes

ArcGIS for Desktop Standard: Yes

ArcGIS for Desktop Advanced: Yes