Maps (2D)

Create and display a map

You can display a basic map by creating one with a basemap layer, setting its initial extent, and adding it to a map view. To learn how to add additional data, see the Layers topic.

Steps

1. Create a new ArcGISMap , passing a BasemapStyle into the constructor.
2. Optionally, add one or more data layers to the map.
3. Assign the map to a MapView control in your app.
4. Set the map view Viewpoint to focus on a specified area of the map.

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
    ArcGISRuntimeEnvironment.setApiKey("YOUR_API_KEY")

    val map = ArcGISMap(BasemapStyle.ARCGIS_NAVIGATION)

    mapView.map = map

    val latitude = 34.0270
    val longitude = -118.8050
    val scale = 72000.0
    mapView.setViewpoint(Viewpoint(latitude, longitude, scale))

You can also create and save a web map using ArcGIS Pro or the ArcGIS Online map viewer and open it in your ArcGIS Runtime app.

Display a mobile map

This example displays a map from a mobile map package. You can create your own mobile map (or scene) packages using ArcGIS Pro or download existing ones from ArcGIS Online. The Yellowstone mobile map package, for example, shows points of interest in Yellowstone National Park.

Steps

1. Create a MobileMapPackage using the path to a local .mmpk file.
2. Call MobileMapPackage.loadAsync() to load the package.
3. When the package loads, get the first map from the package using the MobileMapPackage.getMaps() property.
4. Display the map in a MapView .

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
    mapPackage = MobileMapPackage(mmpkFile).also {
      // load the mobile map package asynchronously
      it.loadAsync()
    }

    // add done listener which will invoke when mobile map package has loaded
    mapPackage.addDoneLoadingListener() {
      if (mapPackage.loadStatus === LoadStatus.LOADED && mapPackage.maps.isNotEmpty()) {
        mapView.map = mapPackage.maps[0]
      }
    }