Data files

What is a data file?

A data file is a local file stored on a device that contains data that can be displayed by a layer in a map or scene. Some data files also support editing, querying, and analyzing data. Data files can be created using a number of tools or scripts, or downloaded from the internet.

You use data files to create offline applications that:

• Display maps or scenes without a network connection.
• Can access, display, and analyze data sideloadedSideloading is the process of deploying a file or package to a device without using a network.Learn more onto a device.
• Include data with an application install.
• Collect data on devices that never have access to a network connection.
• Share datasets between applications using peer-to-peer technology.

Types of data files

The following types of data files are supported directly by the ArcGIS Maps SDKs for Native AppsArcGIS Maps SDKs for Native Apps, previously known as ArcGIS Runtime SDKs, are developer products for building mapping and spatial analysis applications for native devices.Learn more:

How to work with data files

The general workflow to work with a data file in an offline application is:

1. Create

To begin working with a data file, you need to have one of the supported data files. You can either create your own data files using ArcGIS Pro, tools, and scripts, or download public data files from the internet.

When choosing a data file to host in your offline app, make sure that its type is also supported by your license level. A license is needed for when you want to deploy your app to production. Some data files such as vector tile package, image tile package, and mobile geodatabase are supported by the Lite license, which is the lowest level license. Meanwhile, to use shapefiles, OGC GeoPackage, KML files, or local raster files, you need a Basic license.

The typical steps to create a data file are:

1. Determine the data file you will need in your offline app from the list of supported data files.
2. Use tools in ArcGIS Pro or the portal to import dataset.
3. Export into the desired data file format.

2. Manage

Once you have your data file, you sideload or download it onto a device. You can then access it directly from local storage. Optionally, you can also include the data file in your application build folder and reference the folder path in your offline app.

The typical steps to manage a data file are:

1. Transfer the data file onto your device through sideloading or including it in the application build folder.
2. Keep note of the location path of the data file, since you will need to reference it in the application code.

3. Access

To display a data file in your offline app, you typically start with a layer that references the shapefile (either in your device or included in the application build), and add the layer to a map or scene.

Once you have your data file displayed in your offline app, you can perform additional capabilities as supported by your file type. Some types of data file support editing, such as mobile geodatabases and shapefiles, while others are read-only. Shapefiles and mobile geodatabases also allow you to perform SQL queries on them. Additionally, you can apply a renderer to define symbols for features in the layer. Shapefiles, GeoPackages, and mobile geodatabase tables only have a default renderer with black solid symbols when first applied to a layer.

The typical steps to access a data file (in this case, a shapefile) are:

1. Set up your project using one of the ArcGIS Maps SDKs for Native AppsArcGIS Maps SDKs for Native Apps, previously known as ArcGIS Runtime SDKs, are developer products for building mapping and spatial analysis applications for native devices.Learn more for your platform of choice within your preferred IDE.

2. Create a ShapefileFeatureTable referencing the shapefile in local storage.
3. Create a FeatureLayer with the ShapefileFeatureTable.
4. Add the FeatureLayer to a Map displayed in a MapView.

Code examples

1
2
3
4
5
6

var shapefileTable = new ShapefileFeatureTable("\\path\\to\\shapefile.shp");

var shapefileLayer = new FeatureLayer(shapefileTable);

MainMapView.Map.OperationalLayers.Add(shapefileLayer);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
try
{
    var geoPackage = await GeoPackage.OpenAsync("\\path\\to\\geopackage.gpkg");
    await geoPackage.LoadAsync();

    foreach (var table in geoPackage.GeoPackageFeatureTables)
    {
        var featureLayer = new FeatureLayer(table);
        MainMapView.Map.OperationalLayers.Add(featureLayer);
    }
}
catch(Exception ex)
{
    // Handle error
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
try
{
    var shapefileTable = await ShapefileFeatureTable.OpenAsync("\\path\\to\\shapefile");

    var queryParameters = new QueryParameters { WhereClause = "Shape__Length > 150" };

    var queryResult = await shapefileTable.QueryFeaturesAsync(queryParameters);

    foreach(var feature in queryResult)
    {
        double shapeLength = (double)feature.Attributes["Shape__Length"];
        // do something with shapeLength value
    }

}
catch (Exception ex)
{
    // Handle error
}

Tutorials

How-tosTutorialsSamples

Create an offline app with a mobile map package

Learn how to build an offline app using a mobile map package created in ArcGIS Pro.