Display a map from a mobile map package

Learn how to display a map from a mobile map package (MMPK).

In this tutorial you will display a fully interactive map from a mobile map package (MMPK). The map contains a basemap layer and data layers and does not require a network connection.

Prerequisites

Before starting this tutorial:

You need an ArcGIS Location Platform or ArcGIS Online account.
Your system meets the system requirements.

Steps

Open the Xcode project

To start the tutorial, complete the Display a map tutorial or download and unzip the solution.
Open the .xcodeproj file in Xcode.

Add a mobile map package

You will add a mobile map package (MMPK) to your Xcode project. To get an .mmpk file, you can complete the Create a mobile map package tutorial or download its solution.

Once you have the mobile map package:

In Xcode's app menu, click File > Add Files to "...".
Navigate to and select the .mmpk file. If you used the tutorial solution, it will be named MahouRivieraTrails.mmpk.
Choose Options, select the Copy items if needed checkbox, and ensure the project target is selected in Add to targets. Click Add.

Open the mobile map package and display a map

Select a map from the maps contained in a mobile map package, and display it in a map view. Use the AGSMobileMapPackage class to access the mobile map package, and load it to read its contents.

In Xcode, in the Project Navigator, click ViewController.swift.
In the editor, modify the setupMap() function to create an AGSMobileMapPackage referencing the mobile map package you added to the project.
ViewController.swift
Use dark colors for code blocks
23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 24 25 26 27 28 29 29 29 29 29 29 29 29 29 29 29 29 30 30 30 30 30 30 30 30 30 30
Change lineChange lineChange line
```
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
    private func setupMap() {

        let mobileMapPackage = AGSMobileMapPackage(
            name: "MahouRivieraTrails"
        )

    }
```
The file name must match exactly, but the file extension is not required. The name reflects the MahouRivieraTrails.mmpk added to the bundle.
If you sideload or download the .mmpk file, you should provide the full file URL to the file's location on the device.

Load the AGSMobileMapPackage and check that it loads without error. Display the first map in the package in the map view.

ViewController.swift
Use dark colors for code blocks
23
23
23
23
23
23
23
23
23
23
23
23
23
23
23
23
23
23
23
23
23
23
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
41
41
41
41
41
41
41
41
41
Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.    private func setupMap() {

        let mobileMapPackage = AGSMobileMapPackage(
            name: "MahouRivieraTrails"
        )

        mobileMapPackage.load { [weak self] error in
            if let error = error {
                print("Error loading the mmpk: \(error.localizedDescription)")
                return
            }

            if let map = mobileMapPackage.maps.first {
                self?.mapView.map = map
            }
        }

    }

An AGSMobileMapPackage can contain many maps in a maps array.

Loading the mobile map package is an asynchronous process, and the Runtime API takes care of reading the file on a thread that will not block the UI.

Press Command + R to run the app.

If you are using the Xcode simulator your system must meet these minimum requirements: macOS Big Sur 11.3, Xcode 13, iOS 13. If you are using a physical device, then refer to the system requirements.

You should see a map of trail heads, trails, and parks for the area south of the Santa Monica mountains. You will be able to pinch (to zoom and rotate), drag, and double-tap the map view to explore the map.

What's next?

Learn how to use additional API features, ArcGIS location services, and ArcGIS tools in these tutorials:

Display an offline map (on-demand)