Class MobileMapPackage
A mobile map package.
Inheritance
Implements
Namespace: Esri.ArcGISRuntime.Mapping
Assembly: Esri.ArcGISRuntime.dll
Syntax
public sealed class MobileMapPackage : ILoadable
Remarks
Mobile map packages allow you to work with maps on a mobile device. A mobile map package contains all of the files necessary to work with your maps and is stored on a device as either:
- A single archive file with a .mmpk extension.
- A directory containing an unpacked mobile map package.
You can create a mobile map package using either:
-
ArcGIS Pro (from version 1.3). This API version supports any
Mobile
Map up to major version 5. Mobile map packages created with ArcGIS Pro are stored in a file with an .mmpk extension.Package -
Use the
Generate
Offline method to generate and download a mobile map package on-demand, or use DownloadMap(Generate Offline Map Parameters, String) Preplanned to download a mobile map package already prepared by the map author. Mobile map packages created with the OfflineOffline Map(Download Preplanned Offline Map Parameters, String) Map are stored in a directory containing an unpacked mobile map package.Task
A mobile map package can encapsulate one or more maps along with their layers and data. Each package contains an Item with metadata about the package (description, thumbnail, etc.).
Mobile map packages created with ArcGIS Pro can also include transportation networks, locators, and links to online services. You can choose whether to use:
- A tile package (such as .tpkx or .vtpk) or an online basemap as the Basemap.
-
A mobile geodatabase (.geodatabase) or an online feature service as one of the
Operational
Layers .
Online services (such as traffic or weather) can provide excellent contextual information for your users. If the mobile map package is going to be used in areas of poor connectivity, however, you must ensure that data critical to your workflow is stored locally on the device.
Mobile map packages implement the ILoadable interface; you need to load the
Mobile
- Determine the version of this package using the Version property. This API currently supports mobile map packages up to and including major version 5. If the package is from an unsupported version, it will fail to load.
- Discover whether the mobile map package has expired using the Expiration property.
-
Access the individual maps and display them in a Map
View . -
Programmatically add, remove, or modify layers by setting a display filter, changing the renderer, or
changing the visibility on layers. These changes will not be persisted because mobile map packages are
read-only. You cannot change the underlying data in the tables for layers in a mobile map package.
However, if you create a Feature
Collection based on the FeatureLayer Query of a FeatureResult Layer in the mobile map package, you can edit the data in the FeatureCollection 's FeatureLayer Collection . For offline editing, you may also consider using the ahead-of-time or on-demand workflow offered by the OfflineTable Map .Task
Constructors
Name | Description |
---|---|
Mobile |
Initializes a new instance of the Mobile |
Properties
Name | Description |
---|---|
Expiration | Gets the expiration details for this mobile map package, if provided. |
Item | Gets the mobile map package's Item describing metadata about the package. |
Load |
Gets the System. |
Load |
Gets the load status. |
Locator |
Gets the Locator |
Maps | Gets a collection of Maps from the Mobile |
Path | Gets the path to the mobile map package. |
Version | Gets the mobile map package's version. |
Methods
Name | Description |
---|---|
Cancel |
Cancel loading metadata for the object. |
Close() | Closes a mobile map package. |
Load |
Load the metadata for the object asynchronously. |
Open |
Opens a new instance of the Mobile |
Retry |
Loads or retries loading metadata for the object asynchronously. |
Unpack |
Unpacks a mobile map package file (.mmpk) to an output directory. |
Unpack |
Unpacks a mobile map package file (.mmpk) to an output directory. |
Events
Name | Description |
---|---|
Loaded | Event that is raised when the object is done loading. |
Load |
Event that is raised when the Load |
Applies to
Target | Versions |
---|---|
.NET Standard 2.0 | 100.3 - 200.6 |
.NET | 100.13 - 200.6 |
.NET Windows | 100.13 - 200.6 |
.NET Android | 200.0 - 200.6 |
.NET iOS | 200.0 - 200.6 |
.NET Framework | 100.0 - 200.6 |
Xamarin.Android | 100.0 - 100.15 |
Xamarin.iOS | 100.0 - 100.15 |
UWP | 100.0 - 200.6 |