Import Tile Cache (Data Management)


Imports tiles from an existing tile cache or a tile package. The target cache must have the same tiling scheme, spatial reference, and storage format as the source tile cache.


  • Use this tool to import all or portions of a cache from one tile cache to another.

  • This tool supports the Parallel Processing environment setting.


ImportTileCache(in_cache_target, in_cache_source, {scales}, {area_of_interest}, {overwrite})
ParameterExplanationData Type

An existing tile cache to which the tiles will be imported.

Raster Layer

An existing tile cache or a tile package from which the tiles are imported.

Raster Layer; File

A list of scale levels at which tiles will be imported.


An area of interest will spatially constrain where tiles are imported into the cache.

This parameter is useful if you want to import tiles for irregularly shaped areas.

Feature Set

Determines whether the images in the destination cache will be merged with the tiles from the originating cache or overwritten by them.

  • MERGEWhen the tiles are imported, transparent pixels in the originating cache are ignored by default. This results in a merged or blended image in the destination cache. This is the default.
  • OVERWRITEThe import replaces all pixels in the area of interest, effectively overwriting tiles in the destination cache with tiles from the originating cache.

Derived Output

NameExplanationData Type

The updated tile cache.

Raster Layer

Code sample

ImportTileCache example 1 (Python window)

This is a Python sample for the ImportTileCache tool.

import arcpy

                                 "4000;2000;1000", "#","MERGE")
ImportTileCache example 2 (stand-alone script)

This is a Python script sample for the ImportTileCache tool.

#Import tile cache for some levels from a pre-existing tile cache

import arcpy

cacheTarget = "C:/Data/CacheDatasets/Target"
cacheSource = "C:/Data/CacheDatasets/Source"
scales = "4000;2000;1000"
areaofinterest = "#"
overwrite = "MERGE"

arcpy.ImportTileCache_management(cacheTarget, cacheSource, scales, 
                                 areaofinterest, overwrite)


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

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics