Skip To Content

Manage hosted scene layers

Publishing a scene from ArcGIS Pro can create both a scene layer and an associated feature layer. Publishing a scene layer from a hosted feature layer also associates the two layers with one another. If data in the associated point or multipatch feature layer changes, you can rebuild the scene layer cache to include changes for specific layers or changes from all layers in the feature layer.

Only the owner of the hosted scene layer or an administrator in the ArcGIS Online organization can rebuild the cache on the scene layer.

Rebuild the scene layer cache

You (or the administrator in your organization) can rebuild all or part of the scene layer cache for specific sublayers after editors make changes in the associated feature layer.

  • For point feature layers edited, rebuilding the cache incorporates all appended features and edits to feature geometry and attributes into the scene cache.
  • For multipatch feature layers, rebuilding the cache incorporates attribute updates and appended features into the scene cache.
  • You can update those parts of the scene cache that were affected by edits made in the associated hosted feature layer rather than rebuilding the entire scene cache for the following:
    • 3D object scene layers with associated feature layers that you publish from ArcGIS Pro 2.4 with editing enabled
    • 3D object scene layers you enable for updates when you publish them from multipatch feature layers in ArcGIS Online.

    You can enable update support after you publish a 3D object scene layer with an associated feature layer, but you must enable change tracking on the feature layer and then rebuild the full scene layer cache to support partial updates later.

For example, if the associated feature layer contains points that represent street furniture—such as benches, fountains, and planters—and the locations of some of the benches change, you can rebuild the scene cache to reflect the new position of those benches. Similarly, if some of the benches are rebuilt with a different material, and the style in the scene layer varies depending on material type, rebuild the scene layer to include the new attribute and, therefore, the new style.

Tip:

To improve drawing performance, edit the scene layer in ArcGIS Pro rather than editing the associated feature layer in Map Viewer. You can also edit geometry for multipatch data when you edit in ArcGIS Pro, which you cannot do in Map Viewer at this time. See Edit a scene layer with associated feature layer in the ArcGIS Pro help for information on editing scene layers.

Keep the following in mind when deciding whether to update the entire cache or only the parts of the cache affected by changes in the associated feature layer:

  • In most cases, updating part of the cache takes less time than rebuilding the entire cache. However, scene layer performance may degrade over time if you only rebuild parts of the cache. Eventually, you will need to rebuild the entire cache to optimize cache and, therefore, scene layer performance. When the scene layer reaches a state that requires that you rebuild the entire cache, the option to rebuild only part of the cache will be disabled. After you rebuild the whole scene layer cache, the option to rebuild parts of the cache will be available again.
  • If you calculate values in one or more fields in the associated hosted feature layer and the calculation affects all features in the layer, a partial cache update may take more time than a full cache update.

Rebuild the cache

Follow these steps to rebuild the scene layer to incorporate changes from the associated point or multipatch feature layer.

Note:

Rebuilding the scene layer consumes credits.

  1. Sign in to ArcGIS Online as the scene layer owner or an administrator.
  2. Open the item details for the scene layer, click the Settings tab, and scroll down to the Scene Layer Settings section.
  3. Click Manage Cache.
  4. Choose what you want to rebuild.
    • To rebuild the entire hosted scene layer, choose Full cache. This will pick up schema changes on all layers.
    • To only rebuild geometry and nonspatial attribute changes for specific point layers in the hosted scene layer, choose Selected layers. This will pick up geometry and attribute changes on the selected layers. You'll choose the layers in the next step.
    • To rebuild only those parts of a multipatch scene layer that have changed as a result of edits to the scene layer's associated hosted feature layer, choose Partial update. Only geometry and attribute changes since the last update will be rebuilt.

    The Partial update option is not available for point scene layers or 3D object scene layers for which the associated hosted feature layer does not have the Keep track of created and updated features option enabled.

  5. If you're rebuilding to get changes in specific layers within the feature layer, choose the layers from the list.
  6. Click Rebuild Cache.
  7. Click OK to confirm you want to rebuild the cache.

    This dialog box indicates the number of credits that rebuilding the cache consumes. Rebuilding the scene cache may take a long time because all the data from the associated feature layer is cached. The time it takes to rebuild the cache depends on the size of your data.

    To monitor the status of the cache, click Job Status. If the cache fails to rebuild, click the job ID for information about why it failed.