Skip To Content

Export Tile Cache

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 Pro or mobile devices.

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})
ParameterExplanationData 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_CACHEA stand-alone cache raster dataset. This is the default.
  • TILE_PACKAGEA 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.

  • COMPACTGroup tiles into large files called bundles. This storage format is more efficient in terms of storage and mobility. This is the default.
  • EXPLODEDEach 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.

The area of interest can be a feature class or a feature that you draw on the map.

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

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 Desktop Basic: Yes
  • ArcGIS Desktop Standard: Yes
  • ArcGIS Desktop Advanced: Yes

Related topics