Manage hosted 3D layers

You can manage the following for hosted 3D layers:

  • Rebuild the layer cache for 3D layers that have associated feature layers.

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

  • Replace 3D layers that don't have an associated feature layer.

    If the layer does not have an associated feature layer but the layer source is a scene service, you can update the layer's contents by replacing it with another 3D layer that has a scene service source.

    Tip:

    The layer's source is listed on the Overview tab of the layer's item page.

  • Enable data export from a 3D layer that has a scene service source.

    When you enable the ability to export data, the 3D layer can be used as input for geoprocessing tools. This setting is not supported for voxel layers.

Only the owner of the 3D layer or an organization administrator can rebuild the cache on the layer or replace the layer.

Rebuild the hosted 3D layer cache

The layer owner or an administrator in the organization can rebuild all or part of the 3D layer cache for specific sublayers after editors make changes in the associated feature layer.

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

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

For example, if the 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 3D 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 3D layer varies depending on material type, rebuild the 3D layer cache to include the new attribute and, therefore, the new style.

Tip:

To improve drawing performance, edit the 3D layer in ArcGIS Pro rather than editing the associated feature layer in Map Viewer or Map Viewer Classic. You can also edit geometry for 3D object or multipatch features 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 more instructions.

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

  • In most cases, updating part of the cache takes less time than rebuilding the entire cache. However, 3D 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 the cache. When the 3D layer reaches a state that requires that you rebuild the entire cache, the option to rebuild only part of the cache will be unavailable. After you rebuild the whole 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 cache to incorporate changes in point or 3D object layers:

Note:

Rebuilding the layer cache consumes credits.

  1. Sign in to ArcGIS Online as the layer owner or an administrator.
  2. Open the item page for the layer, click the Settings tab, and scroll down to the Scene layer section.
  3. Click Rebuild cache.
  4. Choose what to rebuild.
    • To rebuild the entire cache, choose Full cache. This will pick up schema changes on all layers.
    • To only rebuild geometry and nonspatial attribute changes for specific layers in the hosted 3D 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 3D layer that have changed as a result of edits to the features, choose Partial update. Only geometry and attribute changes since the last update will be rebuilt.

    The Partial update option is not available for 3D point layers or 3D object 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 sublayers, choose them from the list.
  6. Click Rebuild cache.
  7. Click OK to confirm that you want to rebuild the cache.

    This dialog box indicates the number of credits that rebuilding the cache consumes. Rebuilding the 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.

Replace a 3D layer

If the hosted 3D layer does not have an associated feature layer and the 3D layer's source is a scene service, you can update the 3D layer's contents by replacing it with another 3D layer that you published from a scene layer package (SLPK). This allows you to update the contents of a 3D layer without deleting it. You must own both the existing and the replacement layer.

Tip:

If the layer has an associated feature layer, you cannot replace the layer. Rebuild the cache instead. You can identify whether the 3D layer has an associated feature layer by checking the Details section of the 3D layer's item page.

Replacing a 3D layer provides the following benefits:

  • Because the item ID and URL of the existing layer don't change, the scenes and apps that use the layer do not need to be updated to reference a new layer.
  • Replacing the contents of the current layer does not generate new 3D caches. Therefore, no one has to wait for the cache to be rebuilt. Scenes and apps that use the current layer will continue to work after you replace the layer. If the current layer is shared with the public, updates may take up to an hour to display due to caching. Otherwise, updates are immediately reflected in the current layer.
  • The portal creates an archive of the old content, which allows you to revert to this content if necessary.

Note:

Use the same coordinate system for the replacement layer's package as you used for the current layer. This setting must match. In addition, the replacement and existing layer type must be the same.

Follow these steps to replace an existing 3D layer (scene service source) with a another one:

  1. Sign in as the owner of the layer, as an organization administrator, or with an account that has privileges to update all members' items.
  2. Open the item page for the layer.
  3. On the Overview tab, click Replace layer.

    Tip:

    You may need to click the Show more button Show more to see all options.

  4. Click Select layer.

    In the pane that appears, you can search, browse, filter, and sort available layers to find the replacement layer. You can also view the details for each layer by clicking View details.

    Only 3D layers of the same type will be listed in the Select replacement layer window.

  5. When you locate the 3D layer you want to use, click Select.
  6. Click Next to proceed to the Archive window, where you can rename the title of the archive layer.
  7. To import an updated thumbnail, summary, description, and tags from the replacement layer, scroll down and enable Replace item information.

    The summary page shows the current hosted 3D layer, the layer that will replace the content in the current layer, and information related to the archive layer.

  8. To use a different replacement layer, click Select replacement layer and choose a new layer.
  9. Once you are satisfied with the layers, click Replace to perform the replacement operation.

Enable data export

Geoprocessing tools allow you to perform analysis and data manipulation on geographic data. To run a geoprocessing tool on a 3D layer, you must enable data export on the layer.

As the layer owner or an organization administrator, you can enable data export on all types of 3D layers that have a scene service source, except voxel layers.

Follow these steps to enable a 3D layer for data export:

  1. Sign in to the organization as the item owner or an organization administrator.
  2. Open the item page and click the Settings tab.
  3. Scroll to the bottom of the settings and enable the Allow others to export to different formats toggle button.
  4. Click Save.

Share the layer with those who need to run geoprocessing tools on the layer.