Add layers to a 3D scene | ArcGIS for Developers

ArcGIS DevLabs NET Maps & Layers

Overview

You will learn: how to add feature layers to a 3D map.

With ArcGIS Runtime SDK for .NET, it's easy to create a mapping app that displays a basemap and one or more layers. ArcGIS Online hosts several basemaps that you can use in your map (2D) or scene (3D). Feature layers allow you to add datasets hosted online (with ArcGIS Online or other ArcGIS servers) or stored locally (in a runtime geodatabase, for example). The data returned and the symbology used can be customized for a feature layer.

In this lab you will create a new scene with an imagery basemap, add a feature layer to it, and display the scene in your app.

Steps

Create a new ArcGIS Runtime App Visual Studio Project

Start Visual Studio.

Visual Studio 2015 is recommended. Please check system requirements for more information.
Choose File > New > Project and select the Windows > Classic Desktop > ArcGIS Runtime Application (WPF) template.

You need to install the ArcGIS Runtime SDK for .NET Visual Studio Extension to add these templates to Visual Studio. See the Install topic in the developers guide for more information.

Modify the project to display a Scene (3D) instead of a Map (2D)

Open MainWindow.xaml in XAML view.
Replace the existing line of XAML that defines a MapView control with the XAML below for a SceneView.

The MapView and SceneView controls both inherit from the GeoView base class. Any of the data available for a Map (basemaps, feature layers, and so on) can be displayed in 3D by a Scene.
```
<esri:SceneView Scene="{Binding Scene, Source={StaticResource MapViewModel}}" />
```

Create a new scene with an imagery basemap

Open the MapViewModel.cs code file in your project.

The ArcGIS Runtime App templates use the Model-View-ViewModel (MVVM) pattern. The Map property in the MapViewModel class is usually bound to the Map property of a MapView in UI. You will modify this class to include a Scene property for the SceneView to bind to.

Add a Scene property to the MapViewModel class.

private Scene _scene;
public Scene Scene
{
    get { return _scene; }
    set { _scene = value; OnPropertyChanged(); }
}

Add a function to the MapViewModel class that will create a new Scene.
```
private async void CreateNewScene()
{

}
```
Add code to create a new Scene with an imagery basemap.

There are several static methods on the Basemap class that allow you to easily create a basemap for a new Scene: CreateStreets, CreateTopographic, CreateImagery, and so on. At 100.0, vector basemaps are not supported for display in a SceneView.
```
Scene newScene = new Scene(Basemap.CreateImageryWithLabels());
```

Create a new feature layer

Add code that creates a new FeatureLayer. For the layer data source, provide a URI to the Trailheads layer in the Los Angeles Trails map service.

FeatureLayer trailHeadsLayer = new FeatureLayer(new Uri("https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads/FeatureServer/0"));

Load the layer asynchronously and await its completion.

A layer will load automatically when its associated Map loads. Sometimes, however, you might need information about the layer that is only available once it's loaded. In the following code, for example, you'll need the value of the feature layer's FullExtent property to define the area of the initial map display.
```
await trailHeadsLayer.LoadAsync();
```
Add the layer to the map's collection of operational layers.

Operational layers are those that the user can interact with (query, identify, select, and so on). Basemap layers, by contrast, provide a visual context over which operational layers are drawn.
```
newScene.OperationalLayers.Add(trailHeadsLayer);
```
Set the initial display area (Viewpoint) of the map to the extent of features in the trailheads layer.
```
newScene.InitialViewpoint = new Viewpoint(trailHeadsLayer.FullExtent);
```

Display the new scene in your app

Set the MapViewModel.Scene property with your new scene.

It's important to set the Scene property rather than the private _scene variable. Setting the Scene property includes a call to OnPropertyChanged that will let the View know the scene has been updated.
```
Scene = newScene;
```
Call your CreateNewScene function from the MapViewModel constructor.
```
public MapViewModel()
{
   CreateNewScene();
}
```
Run your app to test your code. When the app opens, you should see imagery of Los Angeles appear with trailhead points displayed on top. It might look like a 2D map at the initial scale, zoom out until you see the globe.

Congratulations, you're done!

Checkout and compare with our completed solution project.

Display a web scene

Build an app that displays a web scene stored in ArcGIS Online.

15 minutes Start Lab

Display point, line, and polygon graphics

Create geometries and graphics from coordinates and add them to a map.

15 minutes Start Lab

Search for an address

Find addresses and places with the ArcGIS World Geocoding Service.

15 minutes Start Lab

Get a route and directions

Find the optimal route and directions for multiple stops with the ArcGIS Route service.

20 minutes Start Lab

Challenge

Explore basemaps

Look at the available static methods on the Basemap class for creating basemaps for your Scene. Modify your code to display a different basemap. For example:

Scene newScene = new Scene(Basemap.CreateNationalGeographic());

Add additional feature layers

Visit ArcGIS Online and find additional interesting park datasets to load into the app. Here are a couple suggestions:

Trails (lines): https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails/FeatureServer/0
Parks (polygons): https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Parks_and_Open_Space/FeatureServer/0

Filter features in the trailheads layer

Sometimes you want your layer to show a subset of the data from a service. A definition expression lets you define attribute criteria that restrict the features for a layer. Consult the service info for the Trailheads data source and construct an expression for the layer's DefinitionExpression property that will show only those trailheads without parking.

Explore more NET labs Explore more Maps & Layers labs

ArcGIS DevLabs NET Maps & Layers

15 minutes

Requirements

Solution

Feedback

Overview

Steps

Create a new ArcGIS Runtime App Visual Studio Project

Modify the project to display a Scene (3D) instead of a Map (2D)

Create a new scene with an imagery basemap

Create a new feature layer

Display the new scene in your app

Congratulations, you're done!

Next labs

Challenge

Explore basemaps

Add additional feature layers

Filter features in the trailheads layer