Feature layer (shapefile)

View inQMLC++
View on GitHub
Sample viewer app

Open a shapefile stored on the device and display it as a feature layer with default symbology.

screenshot

Use case

Shapefiles store location, shape and attributes of geospatial vector data. Shapefiles can be loaded directly into ArcGIS Runtime.

How to use the sample

Pan and zoom around the map. View the data loaded from the shapefile.

How it works

  1. Create a ShapefileFeatureTable passing in the URL of a shapefile.
  2. Create a FeatureLayer using the shapefile feature table.
  3. Add the layer to the map's operation layers.

Relevant API

  • FeatureLayer
  • ShapefileFeatureTable

Offline data

Read more about how to set up the sample's offline data here.

Link Local Location
Public Art Shapefile <sdcard>/ArcGIS/Samples/ShapeFile/Aurora_CO_shp/Public_Art.shp

Tags

Layers, shapefile, shp, vector

Sample Code

FeatureLayerShapefile.cppFeatureLayerShapefile.hFeatureLayerShapefile.qml
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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
// [WriteFile Name=FeatureLayerShapefile, Category=Layers]
// [Legal]
// Copyright 2017 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
// http://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.
// [Legal]

#ifdef PCH_BUILD
#include "pch.hpp"
#endif // PCH_BUILD

#include "FeatureLayerShapefile.h"

#include "Map.h"
#include "MapQuickView.h"
#include "Basemap.h"
#include "ShapefileFeatureTable.h"
#include "FeatureLayer.h"

#include <QDir>
#include <QtCore/qglobal.h>

#ifdef Q_OS_IOS
#include <QStandardPaths>
#endif // Q_OS_IOS

using namespace Esri::ArcGISRuntime;

// helper method to get cross platform data path
namespace
{
QString defaultDataPath()
{
  QString dataPath;

#ifdef Q_OS_ANDROID
  dataPath = "/sdcard";
#elif defined Q_OS_IOS
  dataPath = QStandardPaths::writableLocation(QStandardPaths::DocumentsLocation);
#else
  dataPath = QDir::homePath();
#endif

  return dataPath;
}
} // namespace

FeatureLayerShapefile::FeatureLayerShapefile(QQuickItem* parent /* = nullptr */):
  QQuickItem(parent)
{
}

void FeatureLayerShapefile::init()
{
  // Register the map view for QML
  qmlRegisterType<MapQuickView>("Esri.Samples", 1, 0, "MapView");
  qmlRegisterType<FeatureLayerShapefile>("Esri.Samples", 1, 0, "FeatureLayerShapefileSample");
}

void FeatureLayerShapefile::componentComplete()
{
  QQuickItem::componentComplete();

  const QString dataPath = defaultDataPath() + "/ArcGIS/Runtime/Data/shp/";

  // find QML MapView component
  m_mapView = findChild<MapQuickView*>("mapView");

  // Create a map using the streets basemap
  m_map = new Map(BasemapStyle::ArcGISStreets, this);

  // Set map to map view
  m_mapView->setMap(m_map);

  // Create and add the shapefile to the map
  createAndAddShapefileLayer(dataPath + "Public_Art.shp");
}
void FeatureLayerShapefile::createAndAddShapefileLayer(const QString& dataPath)
{
  // Create the ShapefileFeatureTable
  ShapefileFeatureTable* featureTable = new ShapefileFeatureTable(dataPath, this);

  // Create the feature layer from the ShapefileFeatureTable
  FeatureLayer* layer = new FeatureLayer(featureTable, this);

  connect(layer, &FeatureLayer::doneLoading, this, [this, layer](Error loadError)
  {
    if (!loadError.isEmpty())
      return;

    // If the layer was loaded successfully, set the map extent to the full extent of the layer
    m_mapView->setViewpointCenter(layer->fullExtent().center(), 80000);
  });

  // Add the shapefile layer to the map
  m_map->operationalLayers()->clear();
  m_map->operationalLayers()->append(layer);
}

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