Add a feature layer

Learn how to use a URL to access and display a in a

A contains of geographic data. A map contains a and, optionally, one or more . This tutorial shows you how to access and display a in a . You access feature layers with an 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 is a dataset in a hosted in . Each feature layer contains with a single type (, , or ), and a set of . You can use feature layers to store, access, and manage large amounts of geographic data for your applications.

Prerequisites

Before starting this tutorial:

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

  2. Your system meets the system requirements.

  3. The ArcGIS Maps SDK for Qt, version 200.6.0 or later is installed.

  4. The Qt 6.5.6 software development framework is installed.

Open the project in Qt Creator

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

  2. Open the Display_a_map project in Qt Creator.

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

Include header files

  1. Double click on Sources > Display_a_map.cpp to open the file. Include these header files to be able to create ServiceFeatureTable and FeatureLayer instances.

    Display-a-map.cpp
    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
    80
    81
    82
    #include "Display_a_map.h"
    #include "Map.h"
    #include "MapTypes.h"
    #include "MapQuickView.h"
    #include "Point.h"
    #include "Viewpoint.h"
    #include "SpatialReference.h"
    #include <QFuture>
    
    #include "LayerListModel.h"
    #include "ServiceFeatureTable.h"
    #include "FeatureLayer.h"
    

Add a polygon feature layer

This tutorial will draw the map in following order:

  1. ArcGISTopographic basemap style layer
  2. Parks and Open Spaces (polygons)
  3. Trails (lines)
  4. Trailheads (points)

It is important to add feature layers in the correct order so features are displayed correctly. Polygon are typically created before lines or points, so that those features are not obscured by the polygons.

Use the FeatureLayer class to reference the Parks and Open Spaces URL and add features to the .

  1. Go to the Parks and Open Spaces URL and browse the properties of the layer. You may want to explore the Name, Type, Drawing Info, and Fields properties.

  2. Within the setupViewpoint method, add the following code. Create a QUrl instance named polygonFeatureUrl using an ArcGIS feature server as the feature data source. Then create a ServiceFeatureTable named polygon_feature_table from that QUrl.

    Display-a-map.cpp
    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
    80
    81
    82
    void Display_a_map::setupViewpoint()
    {
      const Point center(-118.80543, 34.02700, SpatialReference::wgs84());
      const Viewpoint viewpoint(center, 100000.0);
      m_mapView->setViewpointAsync(viewpoint);
    
      const QUrl polygonFeatureUrl("https://services3.arcgis.com/GVgbJbqm8hXASVYi/ArcGIS/rest/services/Parks_and_Open_Space/FeatureServer/0");
      ServiceFeatureTable* polygon_feature_table = new ServiceFeatureTable(polygonFeatureUrl, this);
    
  3. Create a FeatureLayer instance named polygon_feature_layer, passing in polygon_feature_table as the argument. Then append your new polygon_feature_layer to the Map instance named m_map.

    Display-a-map.cpp
    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
    80
    81
    82
      const QUrl polygonFeatureUrl("https://services3.arcgis.com/GVgbJbqm8hXASVYi/ArcGIS/rest/services/Parks_and_Open_Space/FeatureServer/0");
      ServiceFeatureTable* polygon_feature_table = new ServiceFeatureTable(polygonFeatureUrl, this);
    
      FeatureLayer* polygon_feature_layer = new FeatureLayer(polygon_feature_table, this);
      m_map->operationalLayers()->append(polygon_feature_layer);
    

    Press Ctrl + R to run the app.

    You should see a map view centered in the Santa Monica Mountains, with your feature layer showing the Parks and Open Spaces layer in the map.

Add a line feature layer

Line are typically displayed in a before points. Use the FeatureLayer class to reference the Trails URL and add features to the map, as described next.

  1. Add the following code to create a QUrl instance named lineFeatureUrl using the ArcGIS feature server as the feature data source, in this case, Trails_Styled. Then create a ServiceFeatureTable named line_feature_table from that QUrl.

    Display-a-map.cpp
    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
    80
    81
    82
      FeatureLayer* polygon_feature_layer = new FeatureLayer(polygon_feature_table, this);
      m_map->operationalLayers()->append(polygon_feature_layer);
    
      const QUrl lineFeatureUrl("https://services3.arcgis.com/GVgbJbqm8hXASVYi/ArcGIS/rest/services/Trails/FeatureServer/0");
      ServiceFeatureTable* line_feature_table = new ServiceFeatureTable(lineFeatureUrl, this);
    
  2. Create a FeatureLayer instance named line_feature_layer, passing in line_feature_table as the argument. Then append your new line_feature_layer to the Map instance named m_map.

    Display-a-map.cpp
    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
    80
    81
    82
      const QUrl lineFeatureUrl("https://services3.arcgis.com/GVgbJbqm8hXASVYi/ArcGIS/rest/services/Trails/FeatureServer/0");
      ServiceFeatureTable* line_feature_table = new ServiceFeatureTable(lineFeatureUrl, this);
    
      FeatureLayer* line_feature_layer = new FeatureLayer(line_feature_table, this);
      m_map->operationalLayers()->append(line_feature_layer);
    

    Press Ctrl + R to run the app.

    The map view should display the Parks and Open Spaces layer (polygons) and the Trails (lines) layer.

Add a point feature layer

  1. Add the following code to create a QUrl instance named pointFeatureUrl using the ArcGIS feature server as the feature data source, in this case, Trailheads. Then create a ServiceFeatureTable named point_feature_table from that QUrl.

    Display-a-map.cpp
    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
    80
    81
    82
      FeatureLayer* line_feature_layer = new FeatureLayer(line_feature_table, this);
      m_map->operationalLayers()->append(line_feature_layer);
    
      const QUrl pointFeatureUrl("https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads/FeatureServer/0");
      ServiceFeatureTable* point_feature_table= new ServiceFeatureTable(pointFeatureUrl, this);
    
  2. Add the following two lines of code to create a FeatureLayer, passing in point_feature_table as the argument. Then append your FeatureLayer to the Map instance named m_map.

    Display-a-map.cpp
    Expand
    61 62 63 64 65
    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
    80
    81
    82
      const QUrl pointFeatureUrl("https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads/FeatureServer/0");
      ServiceFeatureTable* point_feature_table= new ServiceFeatureTable(pointFeatureUrl, this);
    
      FeatureLayer* point_feature_layer = new FeatureLayer(point_feature_table, this);
      m_map->operationalLayers()->append(point_feature_layer);
    
    Expand

    Press Ctrl + R to run the app.

The map view should display all three feature layers in the map. Double-click, drag, and scroll the mouse wheel over the map view to explore the map.

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.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close