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 to observe the data 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
This sample downloads the following items from ArcGIS Online automatically:
- Public Art Shapefile - Shapefiles that cover Aurora Colorado: Public art (points), Bike trails (lines), and Subdivisions (polygons).
Tags
layers, shapefile, shp, vector
Sample Code
// 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.
using System;
using Android.App;
using Android.OS;
using Android.Widget;
using Esri.ArcGISRuntime.Data;
using Esri.ArcGISRuntime.Mapping;
using Esri.ArcGISRuntime.UI.Controls;
using ArcGISRuntime.Samples.Managers;
namespace ArcGISRuntime.Samples.FeatureLayerShapefile
{
[Activity (ConfigurationChanges=Android.Content.PM.ConfigChanges.Orientation | Android.Content.PM.ConfigChanges.ScreenSize)]
[ArcGISRuntime.Samples.Shared.Attributes.OfflineData("d98b3e5293834c5f852f13c569930caa")]
[ArcGISRuntime.Samples.Shared.Attributes.Sample(
name: "Feature layer (shapefile)",
category: "Data",
description: "Open a shapefile stored on the device and display it as a feature layer with default symbology.",
instructions: "Pan and zoom around the map to observe the data from the shapefile.",
tags: new[] { "layers", "shapefile", "shp", "vector" })]
public class FeatureLayerShapefile : Activity
{
private MapView _myMapView;
protected override void OnCreate(Bundle bundle)
{
base.OnCreate(bundle);
Title = "Feature layer (shapefile)";
CreateLayout();
// Download (if necessary) and add a local shapefile dataset to the map
Initialize();
}
private async void Initialize()
{
// Create a new map to display in the map view with a streets basemap
_myMapView.Map = new Map(BasemapStyle.ArcGISStreets);
// Get the path to the downloaded shapefile
string filepath = GetShapefilePath();
try
{
// Open the shapefile
ShapefileFeatureTable myShapefile = await ShapefileFeatureTable.OpenAsync(filepath);
// Create a feature layer to display the shapefile
FeatureLayer newFeatureLayer = new FeatureLayer(myShapefile);
// Add the feature layer to the map
_myMapView.Map.OperationalLayers.Add(newFeatureLayer);
// Zoom the map to the extent of the shapefile
await _myMapView.SetViewpointGeometryAsync(newFeatureLayer.FullExtent, 50);
}
catch (Exception e)
{
new AlertDialog.Builder(this).SetMessage(e.ToString()).SetTitle("Error").Show();
}
}
private static string GetShapefilePath()
{
return DataManager.GetDataFolder("d98b3e5293834c5f852f13c569930caa", "Public_Art.shp");
}
private void CreateLayout()
{
// Create a new vertical layout for the app
LinearLayout layout = new LinearLayout(this) { Orientation = Orientation.Vertical };
// Add a map view to the layout
_myMapView = new MapView(this);
layout.AddView(_myMapView);
// Show the layout in the app
SetContentView(layout);
}
}
}