Add layers to a 3D scene

Overview

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

With ArcGIS Runtime SDK for iOS, it's easy to create a mapping app that displays a basemap and one or more layers. ArcGIS Online hosts several tile and vector tile basemaps that you can use in your map (2D) or scene (3D), including streets, satellite, streets-vector, and streets-navigation-vector. You can also add your own datasets by adding feature layers. These layers are hosted by ArcGIS Online or by other ArcGIS servers. By default, feature layers will draw with pre-set symbols to fill the extent of map, but you can provide your own styles with a renderer. The feature layer data can also be controlled by defining a SQL expression to limit the data retrieved. Another common customization is to configure the popup to show specific information about the layer when you click on features in the map.

In this tutorial you will create a simple 3D scene with a satellite basemap, add a feature layer that represents trails near Los Angeles.

Before you begin

Make sure you have installed the latest version of Xcode.

Reuse the starter project

If you have completed the Create a starter app tutorial, then copy the project into a new empty folder. Otherwise, download and unzip the project solution. Open the .xcodeproj file in Xcode. Run and verify the map displays in the device simulator.

Steps

Modify the project to display a scene (3D) instead of a map (2D)

1. Open Main.storyboard in the Project Navigator. Drill down the View Controller Scene tree hierarchy in the Outline View until you reach Map View. Click on the Map View node to select it, and then click on it again to rename it to Scene View.

2. With the Scene View node selected, switch to the Identity inspector tab in the Inspectors panel. Change the class from AGSMapView to AGSSceneView.

3. Open ViewController.swift in the Project Navigator. Change the map view outlet property declaration to scene view.

    /*** Change this ***/
    @IBOutlet weak var mapView: AGSMapView!
    /*** To this ***/
    @IBOutlet weak var sceneView: AGSSceneView!
   

4. Switch back to Main.storyboard and right click on the yellow View Controller node in the Outline View. Disconnect the mapView outlet, and drag the sceneView outlet connector to the Scene View node to connect it.

Create a new scene with an imagery basemap

1. Open ViewController.swift in the Project Navigator. Remove the setupMap function completely and replace it with a new function named setupScene. Use this function to setup and configure your 3D scene. Create a new scene with the imagery basemap and assign it to the scene view.

   private func setupScene() {
       let scene = AGSScene(basemapType: .imageryWithLabels)
       sceneView.scene = scene
   }
   

Add a new feature layer

1. Create an AGSServiceFeatureTable to access the trails data and an AGSFeatureLayer to view it. Add the layer to the scene's operationalLayers.

       let trailsTable = AGSServiceFeatureTable(url: URL(string: "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails/FeatureServer/0")!)
       let trailsLayer = AGSFeatureLayer(featureTable: trailsTable)
       scene.operationalLayers.add(trailsLayer)
   

2. Set the initial display area (Viewpoint) of the map to the extent of features in the trails layer. Use the Camera to provide a specific perspective.

       let camera = AGSCamera(latitude: 33.950896, longitude: -118.525341, altitude: 16000.0, heading: 0, pitch: 50, roll: 0)
       sceneView.setViewpointCamera(camera)
   

Set the elevation source for the scene

1. Use an elevation service provided by Esri and add it to the scene.

       let surface = AGSSurface()
       let elevationSource = AGSArcGISTiledElevationSource(url: URL(string: "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer")!)
       surface.elevationSources.append(elevationSource)
       scene.baseSurface = surface
   

2. Press Command-R to run the app in the iOS Simulator. When the app opens, you should see imagery of Los Angeles appear with trails displayed on top of the map with elevation in 3D. (Note, the simulator does not provide good performance for interacting with the 3D scene. For best experience, run the app on a physical device.)

Congratulations, you're done!

The app should run and show trails displayed on top of a satellite basemap rendered in 3D. Compare your solution with our completed solution project.

Challenge

Explore basemap

Add more layers

Filter features

    let trailsTable = AGSServiceFeatureTable(url: URL(string: "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails/FeatureServer/0")!)
    let trailsLayer = AGSFeatureLayer(featureTable: trailsTable)
    trailsLayer.definitionExpression = "ELEV_GAIN < 250"
    map.operationalLayers.add(trailsLayer)

Investigate the feature request mode