ArcGIS Runtime SDK for Java

Feature Layer Geopackage

Demonstrates how to create a feature layer from a local GeoPackage (.gpkg file).

How it works

To create a FeatureLayer from a local GeoPackage:

  1. Create a GeoPackage passing the URI string into the constructor.
  2. Load the GeoPackage with GeoPackage.loadAsync
  3. When it's done loading, get the GeoPackageFeatureTables inside with geoPackage.getGeoPackageFeatureTables()
  4. For each feature table, create a feature layer with FeatureLayer(featureTable). Add each to the map as an operational layer with map.getOperationalLayers().add(featureLayer)


 * 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
 * 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.

package com.esri.samples.featurelayers.feature_layer_geopackage;

import java.util.List;

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Alert;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

import com.esri.arcgisruntime.layers.FeatureLayer;
import com.esri.arcgisruntime.loadable.LoadStatus;
import com.esri.arcgisruntime.mapping.ArcGISMap;
import com.esri.arcgisruntime.mapping.Basemap;
import com.esri.arcgisruntime.mapping.Viewpoint;
import com.esri.arcgisruntime.mapping.view.MapView;

public class FeatureLayerGeoPackageSample extends Application {

  private MapView mapView;

  public void start(Stage stage) {

    try {
      // create stack pane and application scene
      StackPane stackPane = new StackPane();
      Scene scene = new Scene(stackPane);

      // set title, size, and add scene to stage
      stage.setTitle("Feature Layer GeoPackage Sample");

      // create a map with the streets vector basemap
      ArcGISMap map = new ArcGISMap(Basemap.createStreetsVector());

      // create a GeoPackage from a local gpkg file
      File geoPackageFile = new File("./samples-data/auroraCO/AuroraCO.gpkg");
      GeoPackage geoPackage = new GeoPackage(geoPackageFile.getAbsolutePath());

      // create a feature layer from the first feature table in the gpkg
      geoPackage.addDoneLoadingListener(() -> {
        if (geoPackage.getLoadStatus() == LoadStatus.LOADED) {
          List<GeoPackageFeatureTable> featureTables = geoPackage.getGeoPackageFeatureTables();
          if (featureTables.size() > 0) {
            FeatureLayer featureLayer = new FeatureLayer(featureTables.get(0));
            // zoom to the layer
            featureLayer.addDoneLoadingListener(() ->
              mapView.setViewpointAsync(new Viewpoint(featureLayer.getFullExtent()))
        } else {
          Alert alert = new Alert(Alert.AlertType.ERROR, geoPackage.getLoadError().getMessage());

      // set the map to be displayed in this view
      mapView = new MapView();

      // add the map view to stack pane

    } catch (Exception e) {
      // on any error, display the stack trace.

   * Stops and releases all resources used in application.
  public void stop() {

    if (mapView != null) {

   * Opens and runs application.
   * @param args arguments passed to this application
  public static void main(String[] args) {



In this topic
  1. How it works
  2. Code