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, get an access token and set the API key.

   Instructions to set the API Key

   An API Key gives your app access to secure resources used in this tutorial.

   1. Go to the Create an API key tutorial to obtain a new API key access token using your ArcGIS Location Platform or ArcGIS Online account. Ensure that the following privilege is enabled: Location services > Basemaps > Basemap styles service. Copy the access token as it will be used in the next step.

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

   3. In the Editor, set the ArcGISEnvironment.apiKey property on the ArcGISEnvironment with your access token.

      MainApp.swift

      Expand

      Use dark colors for code blocks

      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
          init() {
              ArcGISEnvironment.apiKey = APIKey("<#YOUR-ACCESS-TOKEN#>")
          }
      

      Expand

Add a feature layer to the map

1. In the project navigator, open the ContentView.swift file. Update the map object. Create a ServiceFeatureTable to access the trail heads data and a FeatureLayer to view it. Add the layer to the map's operational layers.

   More info

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

   • A FeatureLayer and ServiceFeatureTable 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.

   ContentView.swift

   Expand

   Use dark colors for code blocks

   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
       @State private var map: Map = {
           let map = Map(basemapStyle: .arcGISTopographic)
   
           map.initialViewpoint = Viewpoint(latitude: 34.02700, longitude: -118.80500, scale: 72_000)
   
           let featureServiceURL = URL(string: "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads/FeatureServer/0")!
           let serviceFeatureTable = ServiceFeatureTable(url: featureServiceURL)
           let trailheadsLayer = FeatureLayer(featureTable: serviceFeatureTable)
           map.addOperationalLayer(trailheadsLayer)
   
           return map
       }()
   

   Expand

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 14 (Sonoma), Xcode 16, iOS 18. 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?

Learn how to use additional API features, ArcGIS location services, and ArcGIS tools in these tutorials:

• Add a point, line, and polygon
• Display a web map
• Display a scene