Add a feature layer

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

add a feature layer

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.

A feature layer is a dataset in a feature service hosted in ArcGIS. Each feature layer contains features with a single geometry type (point, line, or polygon), and a set of attributes. You can use feature layers to store, access, and manage large amounts of geographic data for your applications.

In this tutorial, you use URLs to access and display three different feature layers hosted in ArcGIS Online:

Prerequisites

Before starting this tutorial:

  1. You need an ArcGIS Location Platform or ArcGIS Online account.

  2. A development and deployment environment that meets the system requirements.

  3. An IDE for Android development in Kotlin.

Steps

Open an Android Studio project

  1. To start this tutorial, complete the Display a map tutorial. Or download and unzip the Display a map solution in a new folder.

  2. Modify the old project for use in this new tutorial. Expand More info for instructions.

  3. If you downloaded the solution, get an access token and set the API key in MainActivity.kt.

Add import statements

In MainScreen.kt, replace the import statements with the imports needed for this tutorial.

MainScreen.kt
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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
@file:OptIn(ExperimentalMaterial3Api::class)

package com.example.app.screens

import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.Scaffold
import androidx.compose.material3.Text
import androidx.compose.material3.TopAppBar
import androidx.compose.runtime.Composable
import androidx.compose.runtime.remember
import androidx.compose.ui.Modifier
import androidx.compose.ui.res.stringResource
import com.arcgismaps.data.ServiceFeatureTable
import com.arcgismaps.mapping.ArcGISMap
import com.arcgismaps.mapping.BasemapStyle
import com.arcgismaps.mapping.Viewpoint
import com.arcgismaps.mapping.layers.FeatureLayer
import com.arcgismaps.toolkit.geoviewcompose.MapView
import com.example.app.R

Change the view point scale

In MainScreen.kt, inside the top-level function createMap(): Modify the Viewpoint constructor call so it passes a scale parameter more appropriate to tutorial.

MainScreen.kt
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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
fun createMap(): ArcGISMap {

    return ArcGISMap(BasemapStyle.ArcGISTopographic).apply {
        initialViewpoint = Viewpoint(
            latitude = 34.0270,
            longitude = -118.8050,

            scale = 200000.0

        )

    }

}

Create service feature tables to reference feature service data

To display three new data layers (also known as operational layers) on top of the current basemap, you will create ServiceFeatureTables using URLs to reference datasets hosted in ArcGIS Online.

  1. Open a browser and navigate to the URL for Parks and Open Spaces to view metadata about the layer. To display the layer in your app, you only need the URL.

  2. In createMap(), before the code that creates the ArcGISMap, do the following.

    1. Create strings that hold the URLs to the hosted layers. The URLs are: Trailheads (points), Trails (lines), and Parks and Open Spaces (polygons).

      MainScreen.kt
      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
      42
      43
      44
      45
      46
      47
      48
      49
      50
      51
      52
      53
      54
      55
      56
      57
      58
      59
      60
      61
      62
      63
      64
      65
      66
      67
      68
      69
      70
      71
      72
      73
      74
      75
      76
      77
      fun createMap(): ArcGISMap {
      
          val parksUrl =
              "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Parks_and_Open_Space_Styled/FeatureServer/0"
          val trailsUrl =
              "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails_Styled/FeatureServer/0"
          val trailHeadsUrl =
              "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads_Styled/FeatureServer/0"
      
          return ArcGISMap(BasemapStyle.ArcGISTopographic).apply {
              initialViewpoint = Viewpoint(
                  latitude = 34.0270,
                  longitude = -118.8050,
      
                  scale = 200000.0
      
              )
      
          }
      
      }
    2. Create three ServiceFeatureTable objects, using a string URL to reference the datasets.

      MainScreen.kt
      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
      42
      43
      44
      45
      46
      47
      48
      49
      50
      51
      52
      53
      54
      55
      56
      57
      58
      59
      60
      61
      62
      63
      64
      65
      66
      67
      68
      69
      70
      71
      72
      73
      74
      75
      76
      77
      fun createMap(): ArcGISMap {
      
          val parksUrl =
              "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Parks_and_Open_Space_Styled/FeatureServer/0"
          val trailsUrl =
              "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails_Styled/FeatureServer/0"
          val trailHeadsUrl =
              "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads_Styled/FeatureServer/0"
      
          val parksServiceFeatureTable = ServiceFeatureTable(parksUrl)
          val trailsServiceFeatureTable = ServiceFeatureTable(trailsUrl)
          val trailHeadsServiceFeatureTable = ServiceFeatureTable(trailHeadsUrl)
      
          return ArcGISMap(BasemapStyle.ArcGISTopographic).apply {
              initialViewpoint = Viewpoint(
                  latitude = 34.0270,
                  longitude = -118.8050,
      
                  scale = 200000.0
      
              )
      
          }
      
      }
    3. You will use FeatureLayers to display the hosted layers on top of the basemap.

      Create three new FeatureLayers using FeatureLayer.createWithFeatureTable(), to which you pass a service feature table.

      MainScreen.kt
      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
      42
      43
      44
      45
      46
      47
      48
      49
      50
      51
      52
      53
      54
      55
      56
      57
      58
      59
      60
      61
      62
      63
      64
      65
      66
      67
      68
      69
      70
      71
      72
      73
      74
      75
      76
      77
      fun createMap(): ArcGISMap {
      
          val parksUrl =
              "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Parks_and_Open_Space_Styled/FeatureServer/0"
          val trailsUrl =
              "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails_Styled/FeatureServer/0"
          val trailHeadsUrl =
              "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads_Styled/FeatureServer/0"
      
          val parksServiceFeatureTable = ServiceFeatureTable(parksUrl)
          val trailsServiceFeatureTable = ServiceFeatureTable(trailsUrl)
          val trailHeadsServiceFeatureTable = ServiceFeatureTable(trailHeadsUrl)
      
          val featureLayerPark = FeatureLayer.createWithFeatureTable(parksServiceFeatureTable)
          val featureLayerTrail = FeatureLayer.createWithFeatureTable(trailsServiceFeatureTable)
          val featureLayerTrailHead = FeatureLayer.createWithFeatureTable(trailHeadsServiceFeatureTable)
      
          return ArcGISMap(BasemapStyle.ArcGISTopographic).apply {
              initialViewpoint = Viewpoint(
                  latitude = 34.0270,
                  longitude = -118.8050,
      
                  scale = 200000.0
      
              )
      
          }
      
      }
  3. In the apply block for ArcGISMap, create a list of these three FeatureLayers, and add them to the map's operationalLayers using addAll().

    MainScreen.kt
    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
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    fun createMap(): ArcGISMap {
    
        val parksUrl =
            "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Parks_and_Open_Space_Styled/FeatureServer/0"
        val trailsUrl =
            "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails_Styled/FeatureServer/0"
        val trailHeadsUrl =
            "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads_Styled/FeatureServer/0"
    
        val parksServiceFeatureTable = ServiceFeatureTable(parksUrl)
        val trailsServiceFeatureTable = ServiceFeatureTable(trailsUrl)
        val trailHeadsServiceFeatureTable = ServiceFeatureTable(trailHeadsUrl)
    
        val featureLayerPark = FeatureLayer.createWithFeatureTable(parksServiceFeatureTable)
        val featureLayerTrail = FeatureLayer.createWithFeatureTable(trailsServiceFeatureTable)
        val featureLayerTrailHead = FeatureLayer.createWithFeatureTable(trailHeadsServiceFeatureTable)
    
        return ArcGISMap(BasemapStyle.ArcGISTopographic).apply {
            initialViewpoint = Viewpoint(
                latitude = 34.0270,
                longitude = -118.8050,
    
                scale = 200000.0
    
            )
    
            operationalLayers.addAll(
                listOf(
                    featureLayerPark,
                    featureLayerTrail,
                    featureLayerTrailHead
                )
            )
    
        }
    
    }
  4. Click Run > Run > app to run the app.

You should see point features (representing trailheads) draw on the map for an area in the Santa Monica Mountains in southern California.

What's next?

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

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.