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.

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.

Prerequisites

Steps

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 Display a map solution, 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. Under Projects, in the display_a_map project, double click Sources > Display_a_map.cpp to open the file.

   3. Replace the string YOUR_API_KEY with the API key from your dashboard.

      
      
      Display_a_map.cpp

      Show more lines

      Change lineChange 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
      //   Copyright 2020 Esri
      //   Licensed under the Apache License, Version 2.0 (the "License");
      //   you may not use this file except in compliance with the License.
      //   You may obtain a copy of the License at
      //
      //   https://www.apache.org/licenses/LICENSE-2.0
      //
      //   Unless required by applicable law or agreed to in writing, software
      //   distributed under the License is distributed on an "AS IS" BASIS,
      //   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
      //   See the License for the specific language governing permissions and
      //   limitations under the License.
      
      
      #include "Display_a_map.h"
      
      #include "ArcGISRuntimeEnvironment.h"
      
      #include "Basemap.h"
      #include "Map.h"
      #include "MapQuickView.h"
      
      
      #include <QUrl>
      
      using namespace Esri::ArcGISRuntime;
      
      Display_a_map::Display_a_map(QObject* parent /* = nullptr */):
        QObject(parent),
      
        m_map(new Map(BasemapStyle::ArcGISTopographic, this))
      
      {
      
        // 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.
        const QString api_key = QStringLiteral("YOUR_API_KEY");
      
        ArcGISRuntimeEnvironment::setApiKey(api_key);
      
      }
      
      Display_a_map::~Display_a_map()
      {
      }
      
      MapQuickView* Display_a_map::mapView() const
      {
        return m_mapView;
      }
      
      void Display_a_map::setupMap()
      {
        const Point center(-118.80543, 34.02700, SpatialReference::wgs84());
        const Viewpoint viewpoint(center, 100000.0);
        m_mapView->setViewpoint(viewpoint);
      }
      
      // Set the view (created in QML)
      void Display_a_map::setMapView(MapQuickView* mapView)
      {
        if (!mapView || mapView == m_mapView)
        {
          return;
        }
      
        m_mapView = mapView;
        m_mapView->setMap(m_map);
      
        setupMap();
      
      
        emit mapViewChanged();
      }
      

      Show more lines

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

   Show more lines

   Add line.Add line.

   14 14 14 14 14 14 14 14 14 14 14 14 14 14 15 16 17 18 19 20 21 22 23 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 24 23 22 21 19 17 15 13 11 9 7 5 3 1 -1 -3 -4 -5 -6 -6 -6 -6 -6 -6 -6 -6 -6 -6 -6 -6 -6 -6 -6 -6 -6

   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
   83
   84
   85
   //   Copyright 2020 Esri
   //   Licensed under the Apache License, Version 2.0 (the "License");
   //   you may not use this file except in compliance with the License.
   //   You may obtain a copy of the License at
   //
   //   https://www.apache.org/licenses/LICENSE-2.0
   //
   //   Unless required by applicable law or agreed to in writing, software
   //   distributed under the License is distributed on an "AS IS" BASIS,
   //   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   //   See the License for the specific language governing permissions and
   //   limitations under the License.
   
   
   #include "Display_a_map.h"
   
   #include "ArcGISRuntimeEnvironment.h"
   #include "Basemap.h"
   #include "Map.h"
   #include "MapQuickView.h"
   #include <QUrl>
   
   #include "ServiceFeatureTable.h"
   #include "FeatureLayer.h"
   
   using namespace Esri::ArcGISRuntime;
   
   Display_a_map::Display_a_map(QObject* parent /* = nullptr */):
     QObject(parent),
     m_map(new Map(BasemapStyle::ArcGISTopographic, this))
   {
     // 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.
     const QString api_key = QStringLiteral("YOUR_API_KEY");
     ArcGISRuntimeEnvironment::setApiKey(api_key);
   }
   
   Display_a_map::~Display_a_map()
   {
   }
   
   MapQuickView* Display_a_map::mapView() const
   {
     return m_mapView;
   }
   
   void Display_a_map::setupMap()
   {
     const Point center(-118.80543, 34.02700, SpatialReference::wgs84());
     const Viewpoint viewpoint(center, 100000.0);
     m_mapView->setViewpoint(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);
   
     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);
   
     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);
   
     FeatureLayer* point_feature_layer = new FeatureLayer(point_feature_table, this);
     m_map->operationalLayers()->append(point_feature_layer);
   
   }
   // Set the view (created in QML)
   void Display_a_map::setMapView(MapQuickView* mapView)
   {
     if (!mapView || mapView == m_mapView)
     {
       return;
     }
   
     m_mapView = mapView;
     m_mapView->setMap(m_map);
   
     setupMap();
   
     emit mapViewChanged();
   }
   

   Show more lines

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 feature layers 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 map.

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 setupMap 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

   Show more lines

   Add line.Add line.

   45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 45 46 47 48 49 50 51 52 53 53 52 51 50 48 46 44 42 40 38 36 34 32 31 30 29 29 29 29 29 29 29 29 29 29 29 29 29 29 29 29 29

   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
   83
   84
   85
   //   Copyright 2020 Esri
   //   Licensed under the Apache License, Version 2.0 (the "License");
   //   you may not use this file except in compliance with the License.
   //   You may obtain a copy of the License at
   //
   //   https://www.apache.org/licenses/LICENSE-2.0
   //
   //   Unless required by applicable law or agreed to in writing, software
   //   distributed under the License is distributed on an "AS IS" BASIS,
   //   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   //   See the License for the specific language governing permissions and
   //   limitations under the License.
   
   
   #include "Display_a_map.h"
   
   #include "ArcGISRuntimeEnvironment.h"
   #include "Basemap.h"
   #include "Map.h"
   #include "MapQuickView.h"
   #include <QUrl>
   
   #include "ServiceFeatureTable.h"
   #include "FeatureLayer.h"
   
   using namespace Esri::ArcGISRuntime;
   
   Display_a_map::Display_a_map(QObject* parent /* = nullptr */):
     QObject(parent),
     m_map(new Map(BasemapStyle::ArcGISTopographic, this))
   {
     // 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.
     const QString api_key = QStringLiteral("YOUR_API_KEY");
     ArcGISRuntimeEnvironment::setApiKey(api_key);
   }
   
   Display_a_map::~Display_a_map()
   {
   }
   
   MapQuickView* Display_a_map::mapView() const
   {
     return m_mapView;
   }
   
   void Display_a_map::setupMap()
   {
     const Point center(-118.80543, 34.02700, SpatialReference::wgs84());
     const Viewpoint viewpoint(center, 100000.0);
     m_mapView->setViewpoint(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);
   
     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);
   
     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);
   
     FeatureLayer* point_feature_layer = new FeatureLayer(point_feature_table, this);
     m_map->operationalLayers()->append(point_feature_layer);
   
   }
   // Set the view (created in QML)
   void Display_a_map::setMapView(MapQuickView* mapView)
   {
     if (!mapView || mapView == m_mapView)
     {
       return;
     }
   
     m_mapView = mapView;
     m_mapView->setMap(m_map);
   
     setupMap();
   
     emit mapViewChanged();
   }
   

   Show more lines

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

   Show more lines

   Add line.Add line.

   51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 51 52 53 54 55 56 56 54 52 50 48 46 44 42 40 38 37 36 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35

   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
   83
   84
   85
   //   Copyright 2020 Esri
   //   Licensed under the Apache License, Version 2.0 (the "License");
   //   you may not use this file except in compliance with the License.
   //   You may obtain a copy of the License at
   //
   //   https://www.apache.org/licenses/LICENSE-2.0
   //
   //   Unless required by applicable law or agreed to in writing, software
   //   distributed under the License is distributed on an "AS IS" BASIS,
   //   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   //   See the License for the specific language governing permissions and
   //   limitations under the License.
   
   
   #include "Display_a_map.h"
   
   #include "ArcGISRuntimeEnvironment.h"
   #include "Basemap.h"
   #include "Map.h"
   #include "MapQuickView.h"
   #include <QUrl>
   
   #include "ServiceFeatureTable.h"
   #include "FeatureLayer.h"
   
   using namespace Esri::ArcGISRuntime;
   
   Display_a_map::Display_a_map(QObject* parent /* = nullptr */):
     QObject(parent),
     m_map(new Map(BasemapStyle::ArcGISTopographic, this))
   {
     // 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.
     const QString api_key = QStringLiteral("YOUR_API_KEY");
     ArcGISRuntimeEnvironment::setApiKey(api_key);
   }
   
   Display_a_map::~Display_a_map()
   {
   }
   
   MapQuickView* Display_a_map::mapView() const
   {
     return m_mapView;
   }
   
   void Display_a_map::setupMap()
   {
     const Point center(-118.80543, 34.02700, SpatialReference::wgs84());
     const Viewpoint viewpoint(center, 100000.0);
     m_mapView->setViewpoint(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);
   
     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);
   
     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);
   
     FeatureLayer* point_feature_layer = new FeatureLayer(point_feature_table, this);
     m_map->operationalLayers()->append(point_feature_layer);
   
   }
   // Set the view (created in QML)
   void Display_a_map::setMapView(MapQuickView* mapView)
   {
     if (!mapView || mapView == m_mapView)
     {
       return;
     }
   
     m_mapView = mapView;
     m_mapView->setMap(m_map);
   
     setupMap();
   
     emit mapViewChanged();
   }
   

   Show more lines

   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 features are typically displayed in a feature layer 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

   Show more lines

   Add line.Add line.

   54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 55 56 57 58 59 59 57 55 53 51 49 47 46 45 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44

   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
   83
   84
   85
   //   Copyright 2020 Esri
   //   Licensed under the Apache License, Version 2.0 (the "License");
   //   you may not use this file except in compliance with the License.
   //   You may obtain a copy of the License at
   //
   //   https://www.apache.org/licenses/LICENSE-2.0
   //
   //   Unless required by applicable law or agreed to in writing, software
   //   distributed under the License is distributed on an "AS IS" BASIS,
   //   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   //   See the License for the specific language governing permissions and
   //   limitations under the License.
   
   
   #include "Display_a_map.h"
   
   #include "ArcGISRuntimeEnvironment.h"
   #include "Basemap.h"
   #include "Map.h"
   #include "MapQuickView.h"
   #include <QUrl>
   
   #include "ServiceFeatureTable.h"
   #include "FeatureLayer.h"
   
   using namespace Esri::ArcGISRuntime;
   
   Display_a_map::Display_a_map(QObject* parent /* = nullptr */):
     QObject(parent),
     m_map(new Map(BasemapStyle::ArcGISTopographic, this))
   {
     // 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.
     const QString api_key = QStringLiteral("YOUR_API_KEY");
     ArcGISRuntimeEnvironment::setApiKey(api_key);
   }
   
   Display_a_map::~Display_a_map()
   {
   }
   
   MapQuickView* Display_a_map::mapView() const
   {
     return m_mapView;
   }
   
   void Display_a_map::setupMap()
   {
     const Point center(-118.80543, 34.02700, SpatialReference::wgs84());
     const Viewpoint viewpoint(center, 100000.0);
     m_mapView->setViewpoint(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);
   
     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);
   
     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);
   
     FeatureLayer* point_feature_layer = new FeatureLayer(point_feature_table, this);
     m_map->operationalLayers()->append(point_feature_layer);
   
   }
   // Set the view (created in QML)
   void Display_a_map::setMapView(MapQuickView* mapView)
   {
     if (!mapView || mapView == m_mapView)
     {
       return;
     }
   
     m_mapView = mapView;
     m_mapView->setMap(m_map);
   
     setupMap();
   
     emit mapViewChanged();
   }
   

   Show more lines

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

   Show more lines

   Add line.Add line.

   57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 58 59 60 61 62 62 60 58 56 55 54 53 53 53 53 53 53 53 53 53 53 53 53 53 53 53 53 53

   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
   83
   84
   85
   //   Copyright 2020 Esri
   //   Licensed under the Apache License, Version 2.0 (the "License");
   //   you may not use this file except in compliance with the License.
   //   You may obtain a copy of the License at
   //
   //   https://www.apache.org/licenses/LICENSE-2.0
   //
   //   Unless required by applicable law or agreed to in writing, software
   //   distributed under the License is distributed on an "AS IS" BASIS,
   //   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   //   See the License for the specific language governing permissions and
   //   limitations under the License.
   
   
   #include "Display_a_map.h"
   
   #include "ArcGISRuntimeEnvironment.h"
   #include "Basemap.h"
   #include "Map.h"
   #include "MapQuickView.h"
   #include <QUrl>
   
   #include "ServiceFeatureTable.h"
   #include "FeatureLayer.h"
   
   using namespace Esri::ArcGISRuntime;
   
   Display_a_map::Display_a_map(QObject* parent /* = nullptr */):
     QObject(parent),
     m_map(new Map(BasemapStyle::ArcGISTopographic, this))
   {
     // 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.
     const QString api_key = QStringLiteral("YOUR_API_KEY");
     ArcGISRuntimeEnvironment::setApiKey(api_key);
   }
   
   Display_a_map::~Display_a_map()
   {
   }
   
   MapQuickView* Display_a_map::mapView() const
   {
     return m_mapView;
   }
   
   void Display_a_map::setupMap()
   {
     const Point center(-118.80543, 34.02700, SpatialReference::wgs84());
     const Viewpoint viewpoint(center, 100000.0);
     m_mapView->setViewpoint(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);
   
     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);
   
     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);
   
     FeatureLayer* point_feature_layer = new FeatureLayer(point_feature_table, this);
     m_map->operationalLayers()->append(point_feature_layer);
   
   }
   // Set the view (created in QML)
   void Display_a_map::setMapView(MapQuickView* mapView)
   {
     if (!mapView || mapView == m_mapView)
     {
       return;
     }
   
     m_mapView = mapView;
     m_mapView->setMap(m_map);
   
     setupMap();
   
     emit mapViewChanged();
   }
   

   Show more lines

   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

   Show more lines

   Add line.Add line.

   60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 61 62 63 64 65 65 64 63 62 62 62 62 62 62 62 62 62 62 62 62 62 62 62 62 62

   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
   83
   84
   85
   //   Copyright 2020 Esri
   //   Licensed under the Apache License, Version 2.0 (the "License");
   //   you may not use this file except in compliance with the License.
   //   You may obtain a copy of the License at
   //
   //   https://www.apache.org/licenses/LICENSE-2.0
   //
   //   Unless required by applicable law or agreed to in writing, software
   //   distributed under the License is distributed on an "AS IS" BASIS,
   //   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   //   See the License for the specific language governing permissions and
   //   limitations under the License.
   
   
   #include "Display_a_map.h"
   
   #include "ArcGISRuntimeEnvironment.h"
   #include "Basemap.h"
   #include "Map.h"
   #include "MapQuickView.h"
   #include <QUrl>
   
   #include "ServiceFeatureTable.h"
   #include "FeatureLayer.h"
   
   using namespace Esri::ArcGISRuntime;
   
   Display_a_map::Display_a_map(QObject* parent /* = nullptr */):
     QObject(parent),
     m_map(new Map(BasemapStyle::ArcGISTopographic, this))
   {
     // 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.
     const QString api_key = QStringLiteral("YOUR_API_KEY");
     ArcGISRuntimeEnvironment::setApiKey(api_key);
   }
   
   Display_a_map::~Display_a_map()
   {
   }
   
   MapQuickView* Display_a_map::mapView() const
   {
     return m_mapView;
   }
   
   void Display_a_map::setupMap()
   {
     const Point center(-118.80543, 34.02700, SpatialReference::wgs84());
     const Viewpoint viewpoint(center, 100000.0);
     m_mapView->setViewpoint(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);
   
     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);
   
     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);
   
     FeatureLayer* point_feature_layer = new FeatureLayer(point_feature_table, this);
     m_map->operationalLayers()->append(point_feature_layer);
   
   }
   // Set the view (created in QML)
   void Display_a_map::setMapView(MapQuickView* mapView)
   {
     if (!mapView || mapView == m_mapView)
     {
       return;
     }
   
     m_mapView = mapView;
     m_mapView->setMap(m_map);
   
     setupMap();
   
     emit mapViewChanged();
   }
   

   Show more lines

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

   Show more lines

   Add line.Add line.

   63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 63 64 65 66 67 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68

   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
   83
   84
   85
   //   Copyright 2020 Esri
   //   Licensed under the Apache License, Version 2.0 (the "License");
   //   you may not use this file except in compliance with the License.
   //   You may obtain a copy of the License at
   //
   //   https://www.apache.org/licenses/LICENSE-2.0
   //
   //   Unless required by applicable law or agreed to in writing, software
   //   distributed under the License is distributed on an "AS IS" BASIS,
   //   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   //   See the License for the specific language governing permissions and
   //   limitations under the License.
   
   
   #include "Display_a_map.h"
   
   #include "ArcGISRuntimeEnvironment.h"
   #include "Basemap.h"
   #include "Map.h"
   #include "MapQuickView.h"
   #include <QUrl>
   
   #include "ServiceFeatureTable.h"
   #include "FeatureLayer.h"
   
   using namespace Esri::ArcGISRuntime;
   
   Display_a_map::Display_a_map(QObject* parent /* = nullptr */):
     QObject(parent),
     m_map(new Map(BasemapStyle::ArcGISTopographic, this))
   {
     // 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.
     const QString api_key = QStringLiteral("YOUR_API_KEY");
     ArcGISRuntimeEnvironment::setApiKey(api_key);
   }
   
   Display_a_map::~Display_a_map()
   {
   }
   
   MapQuickView* Display_a_map::mapView() const
   {
     return m_mapView;
   }
   
   void Display_a_map::setupMap()
   {
     const Point center(-118.80543, 34.02700, SpatialReference::wgs84());
     const Viewpoint viewpoint(center, 100000.0);
     m_mapView->setViewpoint(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);
   
     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);
   
     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);
   
     FeatureLayer* point_feature_layer = new FeatureLayer(point_feature_table, this);
     m_map->operationalLayers()->append(point_feature_layer);
   
   }
   // Set the view (created in QML)
   void Display_a_map::setMapView(MapQuickView* mapView)
   {
     if (!mapView || mapView == m_mapView)
     {
       return;
     }
   
     m_mapView = mapView;
     m_mapView->setMap(m_map);
   
     setupMap();
   
     emit mapViewChanged();
   }
   

   Show more lines

   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 platform services, and ArcGIS tools in these tutorials:

• Add a point, line, and polygon
• Display a scene
• Search for an address
• Get a route and directions
• Find a route and directions
• Display a scene