Maps (2D)

MapsA map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers.Learn more and scenesA scene is a collection of layers that are displayed in 3D. It is typically composed of a basemap layer, data layers, and 3D data.Learn more provide interactive displays of geographic data that enable you to visualize and explore patterns, answer questions, and share insight. They can be opened, edited, and shared across the ArcGIS system and beyond. Maps are designed for interaction in two dimensions (2D) and scenes for interaction in three dimensions (3D).

See Scenes (3D) in this guide for more information about working with scenes.

You can use a map to:

• Display a basemap layerA basemap layer is the layer in a map or scene that displays basemap data. The data source for a basemap layer is typically a basemap service.Learn more such as streets or satellite imagery.
• Access and display data layersA data layer is a layer that references geographic data from a file or a service and is used to visualize the data in a map or scene.Learn more based on files or services, including data you have authored.
• Provide context for temporary points, lines, polygons, or text displayed as graphicsA graphic is a visual element composed of a geometry, symbol, and attributes that is displayed on a map or scene.Learn more.
• Inspect data layers and display information from attributesAttributes are fields and values for a single feature or non-spatial record. They are typically stored in a database or service such as a feature service.Learn more.
• Measure distance and explore spatial relationships between geometriesA geometry is a geometric shape, such as a point, polyline, or polygon, that contains one or more coordinates and a spatial reference.Learn more.
• Save a collection of layers as a web mapA web map is a map stored as a JSON object that defines properties such as the basemap layer, data layers, layer styles, and pop-up styles. Its JSON structure is defined by the web map specification.Learn more to be shared across ArcGIS.

How a map works

A mapA map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers.Learn more works together with a map viewA map view is a user interface that displays map layers and graphics in 2D. It controls the area (extent) of the map that is visible and supports user interactions such as pan and zoom.Learn more to display geographic content in two dimensions. A map contains a collection of layersA layer is a reference to a collection of geographic data that is used to access and display data. The data for layers are typically provided by the basemap layer service and data services.Learn more including multiple data layersA data layer is a layer that references geographic data from a file or a service and is used to visualize the data in a map or scene.Learn more from online or local sources, and a basemap layerA basemap layer is the layer in a map or scene that displays basemap data. The data source for a basemap layer is typically a basemap service.Learn more that gives geographic context. A map can also contain datasets that enable searches for addresses or place names, networks for solving routesA route is a polyline that defines the best path between two or more points in a street network.Learn more, utility networks for tracing the flow of services such as water and electricity, and non-spatial tables. Maps can be created, displayed, edited, and saved. Because the format is based on the ArcGIS web map standard, these maps can be shared uniformly across the ArcGIS system.

For offlineAn offline application, also known as offline app, is an application that runs on a phone, tablet, laptop or desktop device with limited or no network connection. Offline applications are built with ArcGIS Maps SDKs for Native Apps.Learn more workflows (when you don't have network connectivity), you can open a map stored in a mobile map package. Mobile map packages can be created using ArcGIS Pro, ArcGIS Enterprise, or ArcGIS Online. See Offline maps, scenes, and data for more information about implementing offline workflows in your apps.

Map

A map contains a collection of layersA layer is a reference to a collection of geographic data that is used to access and display data. The data for layers are typically provided by the basemap layer service and data services.Learn more displayed in the order in which they were added, with the most recently added layer being displayed above existing layers. You can use the map to change the display order of layers as well as to control which layers are visible, and expose this functionality with user interface controls such as lists, check boxes, or switches. A map also contains a collection of bookmarks, which, similar to a web browser bookmark, allow you to quickly navigate to a predefined area of the map.

You can open an existing map or create one entirely with code. To create a map, you typically first add a basemap layerA basemap layer is the layer in a map or scene that displays basemap data. The data source for a basemap layer is typically a basemap service.Learn more and then one or more data layersA data layer is a layer that references geographic data from a file or a service and is used to visualize the data in a map or scene.Learn more.

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
// Provide an access token for your app (usually when the app starts).
Esri.ArcGISRuntime.ArcGISRuntimeEnvironment.ApiKey = "YOUR_ACCESS_TOKEN";

// Create a map with an ArcGIS basemap.
var map = new Map(BasemapStyle.ArcGISNavigation);

// If preferred, you can provide a key directly for the basemap.
//map.Basemap.ApiKey = "YOUR_ACCESS_TOKEN";

You can also open a map stored in a portalArcGIS portal, also known as a portal, is a website with applications and tools that can be used to create, manage, access, and share geospatial content and data. It supports security and authentication, developer credentials, content and data service management, user and group management, and site administration. A portal can be hosted in Esri's infrastructure or your own infrastructure.Learn more (such as ArcGIS Online) using its URL.

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
Map webMap = new Map(new Uri("https://www.arcgis.com/home/item.html?id=acc027394bc84c2fb04d1ed317aac674"));

You can define the initial extent at which the map will display by setting the Map.InitialViewpoint property.

Layer

Each layerA layer is a reference to a collection of geographic data that is used to access and display data. The data for layers are typically provided by the basemap layer service and data services.Learn more in a map references geographic data, either from an online service or from a local dataset. There are different types of layers that can be added to a map, each designed to display a particular type of data. Some layers display images, such as satellite imagery or aerial photography, while others are composed of a collection of featuresA feature is a single record, also known as a row, that represents a real-world entity. It typically contains a geometry (point, multipoint, polyline, or polygon) and attributes but it can also contain just attributes.Learn more to represent real-world entities using point, line, or polygon geometriesA geometry is a geometric shape, such as a point, polyline, or polygon, that contains one or more coordinates and a spatial reference.Learn more. In addition to geometry, features have attributesAttributes are fields and values for a single feature or non-spatial record. They are typically stored in a database or service such as a feature service.Learn more that provide details about the entity it represents.

The Layer class is the base class for all types of layers used in ArcGIS Maps SDK for .NET. The type of layer you create depends on the type of data you want to display. For example, to display feature data you can create a FeatureLayer that references an online service (such as a feature serviceA feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables.Learn more) or a supported local dataset.

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
// Provide an access token for your app (usually when the app starts).
Esri.ArcGISRuntime.ArcGISRuntimeEnvironment.ApiKey = "YOUR_ACCESS_TOKEN";

var map = new Map(BasemapStyle.ArcGISTopographic);

// Access hosted feature service tables with their URL.
var trailheadsTable = new ServiceFeatureTable(new Uri(
"https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads_Styled/FeatureServer/0"));
var trailsTable = new ServiceFeatureTable(new Uri(
"https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails_Styled/FeatureServer/0"));
var openSpacesTable = new ServiceFeatureTable(new Uri(
"https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Parks_and_Open_Space_Styled/FeatureServer/0"));

// Add layers to the map.
map.OperationalLayers.Add(new FeatureLayer(trailheadsTable));
map.OperationalLayers.Add(new FeatureLayer(trailsTable));
map.OperationalLayers.Add(new FeatureLayer(openSpacesTable));

// Display the map in a map view.
MainMapView.Map = map;

MapView

A map viewA map view is a user interface that displays map layers and graphics in 2D. It controls the area (extent) of the map that is visible and supports user interactions such as pan and zoom.Learn more is a user-interface control that displays a single map in your app. It contains built-in functionality that allows the user to explore the map by zooming in and out, recentering the map display, or getting additional information about elements in the map. It also manages graphicsA graphic is a visual element composed of a geometry, symbol, and attributes that is displayed on a map or scene.Learn more in one or more collections of graphics overlaysA graphics overlay is a client-side, temporary container of graphics to display on a map view or scene view.Learn more. The graphics managed by the map view always display above all layers displayed in the map.

A map viewA map view is a user interface that displays map layers and graphics in 2D. It controls the area (extent) of the map that is visible and supports user interactions such as pan and zoom.Learn more control also allows you to:

• Access data for data layers and graphics.
• Display the current location as a point on the map.
• Identify and select features at a specified location.
• Export an image of the current display.
• Rotate the map display.
• Apply a time extent to filter the display of features.
• Filter layer data using attribute and spatial criteria.
• Display image overlays on the map view.

Display a mapA map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers.Learn more by adding it to a MapView control. Changes you make to the map, such as adding, removing, or reordering layers, will immediately be reflected in the map view display. The Map.InitialViewpoint property will determine the area of the map shown when the map loads. You can also use MapView.SetViewpointAsync() and MapView.SetViewpointRotationAsync() to programmatically change the map area or orientation shown in the display.

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
MapView mapView = new MapView();
mapView.Map = map;
mapView.SetViewpointCenterAsync(latitude: 34.027,
                            longitude: -118.805,
                            scale: 72223.819286);

Examples

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
        MainMapView.Map = new Map(BasemapStyle.ArcGISNavigation);

        MainMapView.SetViewpoint(new Viewpoint(
            latitude: 34.027,
            longitude: -118.805,
            scale: 72223.819286));

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
        // If no URL is provided for CreateAsync, ArcGIS Online is assumed (https://www.arcgis.com).
        ArcGISPortal arcGISOnline = await ArcGISPortal.CreateAsync();

        PortalItem webMapItem = await PortalItem.CreateAsync(arcGISOnline, "41281c51f9de45edaf1c8ed44bb10e30");

        Map webMap = new Map(webMapItem);

        MainMapView.Map = webMap;

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
        MobileMapPackage package = await MobileMapPackage.OpenAsync(filePath);

        await package.LoadAsync();

        MainMapView.Map = package.Maps.First();

Use API key access tokens

An API key access tokenAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more can be used to authorize access to ArcGIS servicesA service, also known as an ArcGIS service, is software that supports an ArcGIS REST API and provides geospatial functionality or data. A service can be hosted by Esri or in ArcGIS Enterprise.Learn more and portal items from your app, as well as to monitor access to those services. You can use a single access tokenAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more for all requests made by your app, or assign individual access tokensAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more for any classes that implement APIKeyResourceInterface.

Tutorials

Display a map

Display a map (.NET MAUI)

Display a web map

Add a point, line, and polygon

Samples

Set basemap

Create and save a map

Open map (URL)

Create geometries

Display device location with autopan modes

Manage operational layers

Services