Add a feature layer

Learn how to use a URL to access and display a feature layerA feature layer (server-side) is a spatially-enabled table in a feature service. All features in a feature layer share the same geometry type and set of fields.Learn more in a map.A map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers.Learn more

A feature layerA feature layer (server-side) is a spatially-enabled table in a feature service. All features in a feature layer share the same geometry type and set of fields.Learn more is a dataset in a feature serviceA feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables.Learn more hosted in ArcGISArcGIS is the brand name for all of the desktop, server, and developer products and technologies offered by Esri.Learn more. Each feature layer contains featuresA feature is a single record, also known as a row, that represents a real-world entity. It typically contains a geometry (point, multipoint, polyline, or polygon) and attributes but it can also contain just attributes.Learn more with a single geometryA geometry is a geometric shape, such as a point, polyline, or polygon, that contains one or more coordinates and a spatial reference.Learn more type (pointA point is a type of geometry containing a single set of x,y coordinates and a spatial reference.Learn more, lineA polyline is a type of geometry containing ordered point coordinates and a spatial reference.Learn more, or polygonA polygon is a type of geometry containing an array of rings and a spatial reference. Each ring contains an array of point coordinates, where the first and last point are the same.Learn more), and a set of attributesAttributes are fields and values for a single feature or non-spatial record. They are typically stored in a database or service such as a feature service.Learn more. You can use feature layers to store, access, and manage large amounts of geographic data for your applications. You can access features from a feature layer using its underlying feature tableA feature table is a database table of a single geometry type, such as point, line, or polygon, that stores features that conform to the schema of the table.Learn more.

In this tutorial, you use URLs to access and display three different feature layersA feature layer (server-side) is a spatially-enabled table in a feature service. All features in a feature layer share the same geometry type and set of fields.Learn more hosted in ArcGIS OnlineArcGIS Online is a GIS mapping, analytics, data hosting, and content management software as a service (SaaS) product. It includes applications, tools, APIs, and location services for users and developers. It is subscription-based and requires an ArcGIS Online account.Learn more:

• Trailheads (points)
• Trails (lines)
• Parks and Open Spaces (polygons)

Prerequisites

Steps

Open a Java project with Gradle

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

2. Open the build.gradle file as a project in IntelliJ IDEA.

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

   More info

   An API keyAn API key is a long-lived access token created using API key credentials. They are valid for up to one year and are typically embedded directly into client applications.Learn more gives your app access to secure resourcesA secure resource is any item or service in an ArcGIS that requires an ArcGIS account and authentication to access. Examples include ArcGIS Location Services, and items and data services in an ArcGIS portal.Learn more used in this tutorial.

   1. Go to the Create an API key tutorial to obtain a new API key access tokenAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more using your ArcGIS Location PlatformAn ArcGIS Location Platform account, formerly known as an ArcGIS Developer account, is an identity associated with an ArcGIS Location Platform subscription.Learn more or ArcGIS OnlineAn ArcGIS Online account, also known as an ArcGIS Organization account, is an identity associated with an ArcGIS Online subscription. It can be used to access ArcGIS tools and develop applications with ArcGIS location services for an organization.Learn more account. Ensure that the following privilegePrivileges are a set of permissions assigned to ArcGIS accounts, developer credentials, and applications that grant access to secure resources and functionality in ArcGIS.Learn more is enabled: Location services > Basemaps > Basemap styles service. Copy the access token as it will be used in the next step.

   2. In IntelliJ IDEA's Project tool window, open src/main/java/com.example.app and double-click App.

   3. In the start() method, set the API key property on the ArcGISRuntimeEnvironment with your access tokenAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more. Replace YOUR_ACCESS_TOKEN with your copied access token. Be sure to surround your access token with double quotes as it is a string.

      App.java

      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
          ArcGISRuntimeEnvironment.setApiKey("YOUR_ACCESS_TOKEN");
      

Add import statements

Add import statements to reference the API classes.

1. In the IntelliJ IDEA's Project tool window, open src/main/java/com.example.app and double-click App.

2. Add the following imports above the existing imports.

   App.java

   Use dark colors for code blocks

   2 2 3 4 5 6 7 8 9 10 10 10 10 10 10 10 9 8 7 6 5 4 3 2 1 0 -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

   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
   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
   78
   79
   import com.esri.arcgisruntime.data.ServiceFeatureTable;
   import com.esri.arcgisruntime.layers.FeatureLayer;
   
   import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
   import com.esri.arcgisruntime.mapping.ArcGISMap;
   import com.esri.arcgisruntime.mapping.BasemapStyle;
   import com.esri.arcgisruntime.mapping.Viewpoint;
   import com.esri.arcgisruntime.mapping.view.MapView;
   

3. In the start() life-cycle method, change the title that will appear on the application window to Add a feature layer.

   App.java

   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
   78
   79
     @Override
     public void start(Stage stage) {
   
       // set the title and size of the stage and show it
   
       stage.setTitle("Add a feature layer tutorial");
   
       stage.setWidth(800);
       stage.setHeight(700);
       stage.show();
   

Create service feature tables to reference feature service data

To display three new data layersA data layer is a layer that references geographic data from a file or a service and is used to visualize the data in a map or scene.Learn more (also known as operational layers) on top of the current basemap, you will create ServiceFeatureTable objects using URLs to reference datasets hosted in ArcGIS OnlineArcGIS Online is a GIS mapping, analytics, data hosting, and content management software as a service (SaaS) product. It includes applications, tools, APIs, and location services for users and developers. It is subscription-based and requires an ArcGIS Online account.Learn more.

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.

   More info

   The service page provides information such as the geometryA geometry is a geometric shape, such as a point, polyline, or polygon, that contains one or more coordinates and a spatial reference.Learn more type, the geographic extentAn extent is a bounding rectangle with points that delineate an area for a map or scene.Learn more, the minimum and maximum scaleZoom level is a value that sets the scale for a map view or a scene view.Learn more at which features are visible, and the attributesAttributes are fields and values for a single feature or non-spatial record. They are typically stored in a database or service such as a feature service.Learn more (fields) it contains. You can preview the layer by clicking on Map Viewer in the "View In:" list at the top of the page.

2. In the start() method, create three ServiceFeatureTable objects, using a string URL in each to reference the datasets. You will add: Trailheads (points), Trails (lines), and Parks and Open Spaces (polygons).

   More info

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

   App.java

   Expand

   Use dark colors for code blocks

   50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 51 52 53 54 55 56 57 58 59 60 61 61 60 59 58 57 57 57 57 57 57 57 57 57 57 57 57 57 57

   Add line.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
   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
   78
   79
       // set the map on the map view
       mapView.setMap(map);
       mapView.setViewpoint(new Viewpoint(34.02700, -118.80543, 144447.638572));
   
       String parksUrl = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Parks_and_Open_Space_Styled/FeatureServer/0";
       String trailsUrl = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails_Styled/FeatureServer/0";
       String trailHeadsUrl = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads_Styled/FeatureServer/0";
   
       ServiceFeatureTable parksServiceFeatureTable = new ServiceFeatureTable(parksUrl);
       ServiceFeatureTable trailsServiceFeatureTable = new ServiceFeatureTable(trailsUrl);
       ServiceFeatureTable trailHeadsServiceFeatureTable = new ServiceFeatureTable(trailHeadsUrl);
   

   Expand

Create feature layers to display the hosted data

You will create three new FeatureLayer objects to display the hosted layers above the basemap.

1. Create three new FeatureLayer objects using the service feature tables and add them to the map as data (operational) layers.

   Data layersA data layer is a layer that references geographic data from a file or a service and is used to visualize the data in a map or scene.Learn more are displayed in the order in which they are added. PolygonA polygon is a type of geometry containing an array of rings and a spatial reference. Each ring contains an array of point coordinates, where the first and last point are the same.Learn more layers should be added before layers with linesA polyline is a type of geometry containing ordered point coordinates and a spatial reference.Learn more or pointsA point is a type of geometry containing a single set of x,y coordinates and a spatial reference.Learn more if there's a chance the polygon symbols will obscure features beneath.

   More info

   A FeatureLayer is simply a reference to a feature service and a fast and easy way to add data to a map. It is accessed via a URL that specifies the endpoint. By default, the API will try to load all of the features that fit into the current view.

   App.java

   Expand

   Use dark colors for code blocks

   58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 58 59 60 61 62 63 64 65 65 65 65 65 65 65 65 65 65 65 65 65 65 65

   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
   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
   78
   79
       ServiceFeatureTable parksServiceFeatureTable = new ServiceFeatureTable(parksUrl);
       ServiceFeatureTable trailsServiceFeatureTable = new ServiceFeatureTable(trailsUrl);
       ServiceFeatureTable trailHeadsServiceFeatureTable = new ServiceFeatureTable(trailHeadsUrl);
   
       map.getOperationalLayers().add(new FeatureLayer(parksServiceFeatureTable));
       map.getOperationalLayers().add(new FeatureLayer(trailsServiceFeatureTable));
       map.getOperationalLayers().add(new FeatureLayer(trailHeadsServiceFeatureTable));
   

   Expand

2. Run the app. Ensure to run the app as a Gradle task and not as an application in your IDE. In the Gradle tool window, under Tasks > application, double-click run.

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 in southern California.

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
• Search for an address