Add a feature layer

Learn how to use a URL to access and display a feature layer in a map.

A map contains layers of geographic data. A map contains a basemap layer and, optionally, one or more data layers. This tutorial shows you how to access and display a feature layer in a map. You access feature layers with an item ID or URL. You will use URLs to access the Trailheads, Trails, and Parks and Open Spaces feature layers and display them in a map.

Prerequisites

Steps

Open the Xcode project

1. To start the tutorial, complete the Display a map tutorial or download and unzip the solution.

2. Open the .xcodeproj file in Xcode.

3. If you downloaded the solution project, set your API key.

   More info

   An API Key enables access to services, web maps, and web scenes hosted in ArcGIS Online.

   1. Go to your developer dashboard to get your API key. For these tutorials, use your default API key. It is scoped to include all of the services demonstrated in the tutorials.

   2. In Xcode, in the Project Navigator, click AppDelegate.swift.

   3. In the editor, set the APIKey property on the AGSArcGISRuntimeEnvironment with your API key.

      
      
      AppDelegate.swift

      Expand

      Use dark colors for code blocks

                                         

      Change line

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
          func application(_ application: UIApplication,
                           didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
              // Note: it is not best practice to store API keys in source code.
              // The API key is referenced here for the convenience of this tutorial.
      
              AGSArcGISRuntimeEnvironment.apiKey = "YOUR_API_KEY"
      
              return true
          }
      

      Expand

Add a feature layer to the map

1. In the project navigator, open the ViewController.swift file. Update the setupMap() method to create an AGSServiceFeatureTable to access the trail heads data and an AGSFeatureLayer to view it. Add the layer to the map's operational layers.

   More info

   • An AGSServiceFeatureTable is effectively an in-memory database of the features from a service URL.

   • An AGSFeatureLayer and AGSServiceFeatureTable work together to request, cache locally, and display features on a map.

   • Operational layers are map layers that users can interact with and appear overlaid on top of the basemap.

   • The trail heads feature service was created in advance for this tutorial. Review the Style feature layers tutorial to learn how.

   ViewController.swift

   Use dark colors for code blocks

                                                       

   Add line.Add line.Add line.Add line.Add line.Add line.

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
       private func setupMap() {
   
           let map = AGSMap(basemapStyle: .arcGISTopographic)
   
           let featureLayer: AGSFeatureLayer = {
               let featureServiceURL = URL(string: "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads/FeatureServer/0")!
               let trailheadsTable = AGSServiceFeatureTable(url: featureServiceURL)
               return AGSFeatureLayer(featureTable: trailheadsTable)
           }()
           map.operationalLayers.add(featureLayer)
   
           mapView.map = map
   
           mapView.setViewpoint(
               AGSViewpoint(
                   latitude: 34.09042,
                   longitude: -118.71511,
                   scale: 200_000
               )
           )
   
       }
   

2. Press <Command+R> to run the app.

   More info

   If you are using the Xcode simulator your system must meet these minimum requirements: macOS Big Sur 11.3, Xcode 13, iOS 13. If you are using a physical device, then refer to the system requirements.

You should see point, line, and polygon features (representing trailheads, trails, and parks) draw on the map for an area in the Santa Monica Mountains.

What's Next?

• Add a point, line, and polygon
• Display a web map
• Display a scene
• Search for an address