Layers with lots of points or vertices prevent vector tiles from being created or published

Description

Large datasets can cause the process of creating or publishing vector tiles in ArcGIS Pro to run out of memory. If this occurs during caching, you may receive an error message such as “Staging failed” or you may see “Error 999999”.

This has been known to happen with data that has many millions of points or vertices, such as large scale captured point data or small interval contours.

Cause

The tool tries to add and process every feature in the data into the root tile. For example, when using the WGS_1984_Web_Mercator_Auxiliary_Sphere coordinate system and the default tiling scheme, the root tile is represented with the “Start Tile” for Level of Detail 0 (LOD 0), as shown on the World Topo Map (MapServer):

• Level ID: 0 [ Start Tile, End Tile ]
  • Resolution: 156543.03392800014
  • Scale: 5.91657527591555E8 (approximately 1:591 million)

If the dataset also covers a large extent, then processing this tile and the tiles in other smaller scales might require many gigabytes of RAM. This can cause the process to fail or take a significantly long time to complete.

Solution or Workaround

Enforce the creation of vector tiles for only the scales that are required for the output. This works best if the layer or vector tiles are not required at smaller scales.

To do this, perform the following steps:

1. Set a Visible Scale Range on the layer:
   1. Determine the smallest scale at which your vector tiles need to be visible.
   2. Open the Layer or Group Layer Properties from the Contents pane of your map.
   3. In the General section, under Visible Scale Range, select Show layer between these scales only and populate the Minimum scale (zoomed out) to match your smallest required scale.
   4. Click Apply and OK.

2. When caching for the web or in the Create Vector Tile Package tool UI, set the Minimum Cached Scale and Maximum Cached Scale parameters to only use the scales that are required in the output.