Maps use a collection of layers
Each layer in a map references geographic data, either from a data service
There are two groups of layers that an ArcGIS Map contains:
- Basemap layers
A basemap layer is the layer in a map or scene that displays basemap data. The data source for a basemap layer is typically a basemap service. , used for geographic context. - Data layers
A data layer is a layer that references geographic data from a file or a service and is used to visualize the data in a map or scene. , used to display geographic data within the context of the basemap.
Key concepts
Basemap Layers
You can use one or more basemap layers to provide a background of geographic context for the data layers displayed in your scene.
The basemap layer service
Data layers
Data layers
Global scenes support data in any geographic coordinate system. Local scenes support any projected coordinate system. Refer to global or local for more information.
Image tile layers
An image tile layer
The tile layer
Vector tile layers
A vector tile layer
Vector tile layers are similar to image tile layers except they store a vector representation of the data. In other words, this format represents geographic features as points, lines, and polygons.
Scene layers
A scene layer
Visualizing your information in 3D makes it easier to intuitively understand and experience geographic information. ArcGIS Maps SDK for Unreal Engine currently supports 3D object scene layers, integrated mesh scene layers, and building scene layers.
3D Tiles layers
A 3D Tiles layer references a tileset that defines spatial data in a hierarchical data structure following the Open Geospatial Consortium (OGC) 3D Tiles specification.
3D Tiles are an OGC standard enabling visualization of 3D content. A 3D tile layer can display data from online services, a tileset (.json), or a 3D tile archive format (.3tz).
Gaussian splat layers
Gaussian splat layers enable visualization of highly detailed reality capture data in 3D scenes.
Gaussian splatting is a reality-capture technique that provides high-fidelity, photorealistic 3D representations using millions of dense points with an elliptical Gaussian distribution, known as splats. A Gaussian splat layer can display georeferenced Gaussian splat datasets from online services or local data sources.
Group layers
A Group layer
Set data layers
- Click on the Layers tab.
- In the Add New Data section, select a layer type from the Layer Type drop-down list.
- In the Layer Source field, introduce an online service URL. If you want to use a local file package, click on ··· and select the file.
- Introduce a name in the Layer Name field.
- Click on the Add button.
When you click the Add button, the layer is listed under the Layers section.
To use private content, select the matching configuration from the Authentication drop-down list in the Layers section. For more information about using private content, see user authentication.
- Click the ArcGIS Map Actor in the Outliner panel.
- Expand the ArcGIS Map Component, then the Layers section in the Details panel.
- Click the + icon on the right side of the section to add a new array element.
- Set a Name and select a layer type from Type drop-down list.
- Set an online service URL or a local file path in the Source field.
To use private content, select the matching configuration from the Authentication drop-down list. For more information about using private content, see user authentication.
- To get a layer collection and add it to the ArcGIS Map, find ArcGIS Maps SDK > ArcGIS Map, select Get Layers, and add it to the graph.
- Use the Set Map node to create a layer collection.
- To add an image tile layer, use the Create ArcGIS Image Layer node.
- To add a vector tile layer, use the Create ArcGIS Vector Tile Layer node.
- To add a 3D object scene layer, use the Create ArcGIS 3DObject Scene Layer node.
- To add an integrated mesh layer, use the Create ArcGIS Integrated Mesh Layer node.
- To add a building scene layer, use the Create ArcGIS Building Scene Layer node.
- To add a point cloud scene layer, use the Create ArcGIS Point Cloud Layer node.
- To add a point scene layer, use the Create ArcGIS Point Scene Layer node.
- To add a group layer, use the Create ArcGIS Group Layer node.
- To set properties for the layer, such as name, visibility, and opacity, select the Create node that has Properties in the name (Create ArcGIS Vector Tile Layer with Properties, for example).
- Connect the API key variable to the API Key pin.
- Use the Add node to add the custom layer to the layer collection.
Use ArcGISImageLayer, ArcGISVectorTileLayer, ArcGIS3DObjectSceneLayer, ArcGISIntegratedMeshLayer, ArcGISBuildingSceneLayer, or ArcGISPointCloudLayer based on the layer you add to the level and register them to the ArcGISMap. Specify the source URL or file path, layer name, opacity value (between 0.0f and 1.0f), visibility, and API key in the constructor. Refer to ArcGISGroupLayer for group layer API.
You can find the sample code to add ArcGISImageLayer and ArcGIS3DObjectSceneLayer in the SampleAPIMapCreator.cpp file. The sample script file is located in:
Plugins/ArcGISMapsSDK/Source/ArcGISSamples/Private
Refer to the FAQ to troubleshoot data loading issues.
Layer management
You can toggle layer visibility on and off, change layer opacity, remove, and reorder layers. When you have multiple layer sources, the last item added to the collection takes precedence and is displayed topmost in the Modes Panel UI.
You can make the following layer management operations under the Layers tab.
- Change the layer order by dragging it to a new order position. The layer at top of the layer list has the highest priority.
- Change a layer name by typing a new name under the Name field.
- Add a new layer by clicking the + icon.
- Delete a layer by clicking the v icon in the layer name row and selecting Delete.
- Delete all layers at once by clicking the trashcan icon.
- Add a layer source by directly pasting the URL to the Source field or loading a file package via the … icon.
- Set a value between
0.0and1.0or use the slider to set the layer opacity. - Hide a layer by marking the checkbox next to the layer name.
- Click on the triangle icon on the left to expand a layer registry and see the layer properties.
- Click the Type drop-down list to change the layer type.
- Replace the layer source URL or file path.
- Select matching authentication configuration.
- Click the gear icon in scene layers properties to configure additional filters or modifications for the layer.
- Click Zoom To Layer to zoom to a specific layer’s extent.
You can make the following layer management operations under the Layers section in the Details panel.
- Change the layer order by dragging it to a new order position. The layer at top of the layer list has the highest priority.
- Change a layer name by typing a new name under the Name field.
- Add a new layer by clicking the + icon.
- Delete a layer by clicking the v icon in the index row and selecting Delete.
- Delete all layers at once by clicking the trashcan icon.
- Add a layer source by directly pasting the URL to the Source field.
- Set a value between
0.0and1.0or use the slider to set the layer opacity. - Hide a layer by marking the Is Visible checkbox.
- Click on the triangle icon on the left to expand a layer registry and see the layer properties.
- Change the layer type by clicking on the Type drop-down list.
- Replace the layer source URL or file path.
- Select matching authentication configuration.
When you use the Create node with Properties in their name to add a layer with Blueprints, you can set opacity and visibility in the node (e.g. Create ArcGIS Image Layer with Properties)
For layer management and other layer operations during the play mode, please refer to the nodes under ArcGIS Maps SDK > ArcGIS Layer or ArcGIS Maps SDK > ArcGIS Layer Collections.
For instance:
- To remove a layer, use the Remove node under ArcGIS Layer Collections.
- To change layer opacity, use the Set Opacity node under ArcGIS Layer.
The ArcGISLayer base class has properties that you can use to layer management during the runtime.
To remove a layer:
auto index = arcGISMap->GetLayers()->IndexOf(layer_3);arcGISMap->GetLayers()->Remove(index);You can update a layer’s name, opacity, and visibility without needing to rebuild the map.
To change the opacity of a layer:
layer_1->SetOpacity(0.9f);You can find the sample code to remove a layer and change the opacity of layers in the SampleAPIMapCreator.cs file. The sample script file is in:
Plugins/ArcGISMapsSDK/Source/ArcGISSamples/Private