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 AGSMap , passing a AGSBasemapStyle into the constructor.
2. Optionally, add one or more data layers to the map.
3. Assign the map to an AGSMapView control in your app.
4. Set the map view AGSViewpoint 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
class ViewController: UIViewController {
    @IBOutlet weak var mapView: AGSMapView!

    private func setupMap() {
        AGSArcGISRuntimeEnvironment.apiKey = "YOUR_ACCESS_TOKEN"

        let map = AGSMap(
            basemapStyle: .arcGISNavigation
        )

        mapView.map = map

        mapView.setViewpoint(
            AGSViewpoint(
                latitude: 34.027,
                longitude: -118.805,
                scale: 72223.819286
            )
        )
    }

    override func viewDidLoad() {
        super.viewDidLoad()
        setupMap()
    }
}

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 web map

You can open a web map saved as an item in a portal, such as ArcGIS Online, using its item ID or URL. A portal item can be secured to only allow access for authorized users, in which case you must provide credentials for access. To learn how to access secured content, see Security and authentication.

Steps

1. Create an AGSPortal object to connect to the portal that hosts a web map you want to load. If you don't provide a portal URL, the connection defaults to ArcGIS Online.
2. Create an AGSPortalItem object using the item ID for the item that stores the web map.
3. Create a new map, passing the portal item into the constructor.
4. Assign the map to an AGSMapView control in your app.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
        AGSArcGISRuntimeEnvironment.apiKey = "YOUR_ACCESS_TOKEN"

        let portal = AGSPortal.arcGISOnline(withLoginRequired: false)
        let itemID = "41281c51f9de45edaf1c8ed44bb10e30"
        let portalItem = AGSPortalItem(portal: portal, itemID: itemID)
        let map = AGSMap(item: portalItem)
        mapView.map = map

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 an AGSMobileMapPackage using the path to a local .mmpk file.
2. Call AGSMobileMapPackage.loadWithCompletion:() to load the package.
3. When the package loads, get the first map from the package using the AGSMobileMapPackage.maps property.
4. Display the map in an AGSMapView .

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
        AGSArcGISRuntimeEnvironment.apiKey = "YOUR_ACCESS_TOKEN"

        //initialize map package
        self.mapPackage = AGSMobileMapPackage(name: "Yellowstone")

        //load map package
        self.mapPackage.load
        let map = self.mapPackage.maps.first

        //assign the first map from the map package to the map view
        self.mapView.map = map