Open a shapefile stored on the device and display it as a feature layer with default symbology.
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
- Create a
ShapefileFeatureTable
passing in the URL of a shapefile. - Create a
FeatureLayer
using the shapefile feature table. - 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
// [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);
}