View in QML C++ View on GitHub Sample viewer app
Display features from a local GeoPackage.
Use case
A GeoPackage is an OGC standard, making it useful when your project requires an open source data format or when other, non-ArcGIS systems may be creating the data. Accessing data from a local GeoPackage is useful when working in an environment that has an inconsistent internet connection or that does not have an internet connection at all. For example, a department of transportation field worker might source map data from a GeoPackage when conducting signage inspections in rural areas with poor network coverage.
How to use the sample
Pan and zoom around the map. View the data loaded from the geopackage.
How it works
Create a GeoPackage
passing the URL string into the constructor.
Load the GeoPackage
with GeoPackage::load
When it's done loading, get the GeoPackageFeatureTable
objects from the geopackage with geoPackage::geoPackageFeatureTables()
Create a FeatureLayer(featureTable)
for the first feature table and add it to the map as an operational layer using, map::operationalLayers()::append(featureLayer)
Relevant API
FeatureLayer
GeoPackage
GeoPackageFeatureTable
Map
Offline data
Read more about how to set up the sample's offline data here .
About the data
The map shows point locations of public art installations in Aurora, Colorado.
feature table, geopackage, gpkg, OGC, package, standards
Sample CodeFeatureLayer_GeoPackage.cpp FeatureLayer_GeoPackage.cpp FeatureLayer_GeoPackage.h FeatureLayer_GeoPackage.qml
Use dark colors for code blocks Copy
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
108
109
110
111
112
113
114
115
116
117
// [WriteFile Name=FeatureLayer_GeoPackage, Category=Features]
// [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 "FeatureLayer_GeoPackage.h"
# include "Map.h"
# include "MapQuickView.h"
# include "GeoPackage.h"
# include "GeoPackageFeatureTable.h"
# include "FeatureLayer.h"
# include "Point.h"
# include "Viewpoint.h"
# include "MapTypes.h"
# include "Error.h"
# include "LayerListModel.h"
# include "SpatialReference.h"
# include "Point.h"
# include "Viewpoint.h"
# include <QUrl>
# include <QtCore/qglobal.h>
# include <QStandardPaths>
using namespace Esri::ArcGISRuntime;
// helper method to get cross platform data path
namespace
{
QString defaultDataPath ()
{
QString dataPath;
# ifdef Q_OS_IOS
dataPath = QStandardPaths:: writableLocation (QStandardPaths::DocumentsLocation);
# else
dataPath = QStandardPaths:: writableLocation (QStandardPaths::HomeLocation);
# endif
return dataPath;
}
} // namespace
FeatureLayer_GeoPackage:: FeatureLayer_GeoPackage (QQuickItem* parent /* = nullptr */ ):
QQuickItem (parent)
{
}
void FeatureLayer_GeoPackage::init ()
{
// Register the map view for QML
qmlRegisterType<MapQuickView>( "Esri.Samples" , 1 , 0 , "MapView" );
qmlRegisterType<FeatureLayer_GeoPackage>( "Esri.Samples" , 1 , 0 , "FeatureLayer_GeoPackageSample" );
}
void FeatureLayer_GeoPackage::componentComplete ()
{
QQuickItem:: componentComplete ();
// find QML MapView component
m_mapView = findChild<MapQuickView*>( "mapView" );
// Create a map using the light gray basemap
m_map = new Map (BasemapStyle::ArcGISLightGray, this );
// Set an initial viewpoint
const Point pt ( -104.8319 , 39.7294 , SpatialReference( 4326 )) ;
const Viewpoint vp (pt, 200000 ) ;
m_map-> setInitialViewpoint (vp);
// Create the GeoPackage
const QString dataPath = defaultDataPath () + "/ArcGIS/Runtime/Data/gpkg/" ;
GeoPackage* gpkg = new GeoPackage (dataPath + "AuroraCO.gpkg" , this );
// Connect to GeoPackage::doneLoading
connect (gpkg, &GeoPackage::doneLoading, this , [ this , gpkg](Error e)
{
if (!e. isEmpty ())
return ;
if (!(gpkg-> geoPackageFeatureTables (). size () > 0 ))
return ;
GeoPackageFeatureTable* gpkgFeatureTable = gpkg-> geoPackageFeatureTables (). at ( 0 );
FeatureLayer* featureLayer = new FeatureLayer (gpkgFeatureTable, this );
m_map-> operationalLayers ()-> append (featureLayer);
});
// Connect to Map::doneLoading
connect (m_map, &Map::doneLoading, this , [gpkg](Error e)
{
if (!e. isEmpty ())
return ;
// load the GeoPackage
gpkg-> load ();
});
// Set map to map view
m_mapView-> setMap (m_map);
}