ArcMap

Export Tile Cache

Summary

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

Usage

  • When exporting a tile cache as a tile package tpk file, the cache storage format is always Compact. When exporting a tile cache as a tile package tpkx file, the cache storage format is always Compact v2.

  • This tool supports the Parallel Processing environment setting.

Syntax

arcpy.management.ExportTileCache(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)

Specifies whether the cache will be exported as a tile cache or a tile package. Tile packages are suitable for ArcGIS Runtime and ArcGIS Mobile deployments.

  • TILE_CACHE —The cache will be exported as a stand-alone cache raster dataset. This is the default.
  • TILE_PACKAGE —The cache will be exported as a single compressed file (.tpk) in which the cache dataset is added as a layer and consolidated so that it can be shared easily. This type can be used in ArcMap as well as in ArcGIS Runtime and ArcGIS Mobile applications.
  • TILE_PACKAGE_TPKX —The cache will be exported using Compact_v2 storage format (.tpkx), which provides better performance on network shares and cloud storage directories. This improved and simplified package structure type is supported by newer versions of the ArcGIS platform such as ArcGIS Online, ArcGIS Pro 2.3, ArcGIS Enterprise 10.7, and ArcGIS Runtime 100.5.
String
storage_format_type
(Optional)

Determines the storage format of tiles.

  • 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 will be 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

Derived Output

NameExplanationData Type
out_cache

The output tile cache or tile package.

Raster Layer; File

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

Licensing information

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

Related topics