Mobile packages

What is a mobile package?

A mobile package is a file created from an ArcGIS Pro project that contains one or more maps or scenes. It also contains data content that is referenced by layers in the maps or scenes. Mobile packages are used to display maps and scenes, geocode, reverse geocode, find routes and directions, and analyze data without a network connection.

You use mobile packages to create offline applications that:

• Display interactive maps or scenes without a network connection.
• Distribute multiple maps or scenes to mobile workers.
• Geocode addresses and find places offline.
• Get nearby addresses (reverse geocode).
• Calculate turn-by-turn directions offline.
• Include maps and scenes with an application install.
• Distribute maps and scenes that cannot be used after a specific date and time.

Types of mobile packages

There are two types of mobile package:

1. Mobile map package (MMPK): This type of package contains maps.
2. Mobile scene package (MSPK): This type of package contains scenes.

How to work with mobile packages

The general workflow to work with a mobile package in an offline application is:

1. Create

To begin working with a mobile package, you need to have ArcGIS Pro installed in your development machine. You will use ArcGIS Pro to author a project containing maps or scenes and other related content. Later, you will use a tool in ArcGIS Pro to package up your project into a mobile map package (.mmpk) file or a mobile scene package (.mspk) file.

Each map or scene contained in a mobile package can include basemap layers, data layers, and non-spatial tables. With ArcGIS Pro 2.6 (or later), you can also reference online layers and tables in your map, such as traffic information or weather conditions. However, these online layers are not included in the package. If your user's device has network connectivity, they can take advantage of these referenced online layers and tables. If network connection is unavailable, users can continue to work with the maps and data that are stored locally in the mobile map package.

The typical steps to create a mobile map package or a mobile scene package are:

2. Manage

After adding maps or scenes, layers, and other data content into your ArcGIS Pro project, you will use the Share Mobile Map Package or the Create Mobile Map Package tool to create a mobile map package (.mmpk) file, or a Create Mobile Scene Package tool to create a mobile scene package (.mspk) file.

Mobile packages support geocoding, routing, and finding places offline. If you want to include these capabilities in your offline app, your mobile package needs to include a locator and a transportation network dataset.

Mobile packages also support an expiry date and time. This is available with ArcGIS Pro 2.4 (or later) with the ArcGIS Publisher extension license. This can be a hard expiry, after which ArcGIS Maps SDKs for Native Apps will not open the mobile package, or a soft expiry after which the SDKs will issue a warning that your offline app can display to its user.

The typical steps to manage a mobile map package or a mobile scene package are:

3. Access

Once you have a mobile map package (.mmpk) or a mobile scene package (.mspk), you can sideload it into your device or include it in your application build folder. Then, you will use ArcGIS Maps SDKs for Native Apps to display the mobile package in your offline application.

If you have a locator or a network dataset included in your mobile package, you can also perform geocoding or routing offline.

The typical steps to access a mobile map package or a mobile scene package in your offline app are:

Code 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
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
        private async Task SetupMap()
        {

            // Define the path to the mobile map package.
            string pathToMobileMapPackage = System.IO.Path.Combine(Environment.CurrentDirectory, @"SantaMonicaParcels.mmpk");

            // Instantiate a new mobile map package.
            MobileMapPackage santaMonicaParcels_MobileMapPackage = new MobileMapPackage(pathToMobileMapPackage);

            // Load the mobile map package.
            await santaMonicaParcels_MobileMapPackage.LoadAsync();

            // Show the first map in the mobile map package.
            this.Map = santaMonicaParcels_MobileMapPackage.Maps.FirstOrDefault();

        }

1
2
3
4
5
6
7
8
9
10
try
{
    var mobileScenePackage = await MobileScenePackage.OpenAsync(path: "path\\to\\file.mspk");
    await mobileScenePackage.LoadAsync();
    MainSceneView.Scene = mobileScenePackage.Scenes.First();
}
catch(Exception ex)
{
    // Handle error.
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
try
{
    var mobileMapPackage = await MobileMapPackage.OpenAsync(path: "\\path\\to\\file.mmpk");
    await mobileMapPackage.LoadAsync();

    var locatorTask = mobileMapPackage.LocatorTask;

    var geocodeResult = await locatorTask.GeocodeAsync("123 Fake Street, Springfield");

    if (geocodeResult.FirstOrDefault()?.DisplayLocation is MapPoint resultLocation)
    {
        await MainMapView.SetViewpointCenterAsync(resultLocation);
    }
}
catch (Exception ex)
{
    // Handle error
}

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
try
{
    var mobileMapPackage = await MobileMapPackage.OpenAsync(path: "\\path\\to\\file.mmpk");
    await mobileMapPackage.LoadAsync();

    if (mobileMapPackage.Maps.FirstOrDefault() is Map map)
    {
        await map.LoadAsync();

        if (map.TransportationNetworks.FirstOrDefault() is TransportationNetworkDataset networkDataset)
        {
            var routeTask = await RouteTask.CreateAsync(networkDataset);

            var startStop = new Stop(point: fromPoint);
            var destinationStop = new Stop(point: toPoint);

            var routeParams = await routeTask.CreateDefaultParametersAsync();
            routeParams.SetStops(new[] { startStop, destinationStop });
            routeParams.ReturnDirections = true;

            var routeResult = await routeTask.SolveRouteAsync(routeParams);

            // Display the route results in a GraphicsOverlay
        }
    }
}
catch (Exception ex)
{
    // Handle the error
}

Tutorials

ToolsAPIs

Create a mobile map package

Use ArcGIS Pro to create a mobile map package.

ArcGIS Pro

Workflows

Create an app using a mobile map package

Learn how to build an offline app using a mobile map package created with ArcGIS Pro.