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
by passing the URL string to the.gpkg
file. - Load the
GeoPackage
withGeoPackage.load
- When it's done loading, get the
GeoPackageFeatureTable
objects from the geopackage withgeoPackage.geoPackageFeatureTables
- Create a
FeatureLayer
for each feature table and add it to the map as an operational layer. Add each to the map as an operational layer withmap.operationalLayers.append(featureLayer)
Relevant API
- FeatureLayer
- GeoPackage
- GeoPackageFeatureTable
- Map
Offline data
Read more about how to set up the sample's offline data here.
Link | Local Location |
---|---|
Aurora, Colorado GeoPackage | <userhome> /ArcGIS/Runtime/Data/gpkg/AuroraCO.gpkg |
About the data
The map shows point locations of public art installations in Aurora, Colorado.
Tags
feature table, geopackage, gpkg, OGC, package, standards
Sample Code
// [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]
import QtQuick 2.6
import Esri.ArcGISRuntime 100.15
import Esri.ArcGISExtras 1.1
Rectangle {
id: rootRectangle
clip: true
width: 800
height: 600
readonly property string dataPath: System.userHomePath + "/ArcGIS/Runtime/Data/gpkg/"
MapView {
id: mapView
anchors.fill: parent
Component.onCompleted: {
// Set the focus on MapView to initially enable keyboard navigation
forceActiveFocus();
}
Map {
id: map
Basemap {
initStyle: Enums.BasemapStyleArcGISLightGray
}
// Load the GeoPackage once the Map loads
onLoadStatusChanged: {
if (loadStatus === Enums.LoadStatusLoaded)
gpkg.load();
}
// set an initial viewpoint
ViewpointCenter {
Point {
y: 39.7294
x: -104.8319
spatialReference: Factory.SpatialReference.createWgs84()
}
targetScale: 200000
}
}
}
// Declare a GeoPackage
GeoPackage {
id: gpkg
path: dataPath + "AuroraCO.gpkg"
// Wait for the GeoPackage to load successfully
onLoadStatusChanged: {
if (loadStatus !== Enums.LoadStatusLoaded)
return;
if (!gpkg.geoPackageFeatureTables.length > 0)
return;
// Get the first feature table
const gpkgFeatureTable = gpkg.geoPackageFeatureTables[0];
// Create a FeatureLayer with the table
const featureLayer = ArcGISRuntimeEnvironment.createObject("FeatureLayer", {featureTable: gpkgFeatureTable});
// Append the layer to the map
map.operationalLayers.append(featureLayer);
}
}
}