Skip To Content

Tile package

Tile packages (.tpk) are a set of tiles (images) from a map or raster dataset that can be published as a web tile or a web elevation layer. Alternatively, the tile package can be used as a basemap in ArcGIS applications.

The tiles are wrapped into a single file, a .tpk file, so you can share the file as you would any file. You can email it, copy it to a network locale, upload it to ArcGIS Online or ArcGIS Enterprise, and so on.

The tiles, known as a tile cache, are static; updates to the input data are not reflected in the tile cache.

Note:

Only maps that contain local data can be cached using the tile package tools in ArcGIS Pro. Online services, such as tiled map services, are not supported. Attempting to package maps that contain online services will result in an error.

Create a tile package for a web tile layer

Web tile layers can be used as a basemap or operational layer in a scene or map. Tile layers can also be published as part of a map or scene, or they can be published on their own. For more information, see Web tile layer.

  1. Optionally use the Generate Map Server Cache Tiling Scheme tool to output a tiling scheme in the projection of your map.
  2. Use the Create Map Tile Package tool with the Package for ArcGIS Online/ Bing Maps/ Google Maps option in one of the following states:
    • Checked to generate a tile package that can be used with ArcGIS Online basemaps.
    • Unchecked to generate a tile package that uses the tiling scheme specified in Service. Service can either be an existing cached service or the tiling scheme you created in step 1.

A tile package is saved locally and can now be uploaded to your ArcGIS Online or ArcGIS Enterprise content to be published as a web tile layer.

The tile package can be uploaded through ArcGIS Online or ArcGIS Enterprise if it's under 1 GB. If it's larger, use the Share Package tool to add it to your content.

Create a tile package for a web elevation layer

Web elevation layers can be used as the elevation source of a scene in either the web scene viewer or ArcGIS Pro. To create a tile package that publishes a web elevation layer, the following must be true:

  • The input raster dataset must represent elevation data.
  • The tiling scheme must use LERC compression.

Note:

Currently, to create a web elevation layer in ArcGIS Online, a tile package must be created first. If you're working with ArcGIS Enterprise or Portal for ArcGIS 10.4 and later, a web elevation layer can be created by sharing a web scene. For more information, see Web elevation layer.

  1. Optionally use the Generate Tile Cache Tiling Scheme tool with Tile Format set to LERC Compression to generate a new LERC tiling scheme based on your elevation dataset.

    Web scenes require that web elevation layers use the same tiling scheme as the basemap. If you're using the elevation layer with ArcGIS Online basemaps, skip this step.

  2. Use the Manage Tile Cache tool to generate a LERC cache. For Input Tiling Scheme use one of the following:
    • Elevation tiling scheme matches the ArcGIS Online/Bing Maps/Google tiling scheme used by ArcGIS Online basemaps.
    • Elevation tiling scheme with two additional levels matches the ArcGIS Online/Bing Maps/Google tiling scheme used by ArcGIS Online basemaps but has two additional levels for higher-resolution data.
    • Import scheme uses the tiling scheme you created in step 1 or the tiling scheme of an existing image service. If using this option, browse to the tiling scheme file or service for Import Tiling Scheme.
      Caution:

      Using a tiling scheme that does not use a LERC compression will result in a web tile layer, not a web elevation layer.

  3. Use the Export Tile Cache tool with the Export Cache As option set to Tile package.

A tile package is saved locally and can now be uploaded to your ArcGIS Online content to be published as a web elevation layer.

The tile package can be uploaded through ArcGIS Online or ArcGIS Enterprise if it's under 1 GB. If it's larger, use the Share Package tool to add it to your content.