Honor mobile map package expiration date

Access the expiration information of an expired mobile map package.

Use case

The data contained within a mobile map package (MMPK) may only be relevant for a fixed period of time. Using ArcGIS Pro, the author of an MMPK can set an expiration date to ensure the user is aware the data is out of date.

As long as the author of an MMPK has set an expiration date, the expiration date can be read even if the MMPK has not yet expired. For example, developers could also use this API to warn app users that an MMPK may be expiring soon.

How to use the sample

Load the sample. The author of the MMPK used in this sample chose to set the MMPK's map as still readable, even if it's expired. The sample presents expiration information to the user.

How it works

1. Create a MobileMapPackage passing in the path to the mobile map package's location on the device.
2. Load the mobile map package.
3. Present Expiration information to the user with:

• Use Expiration.Message to get the expiration message set by the author of the MMPK.
• Use Expiration.DateTime to get the expiration date set by the author of the MMPK.

Relevant API

• Expiration
• MobileMapPackage

Offline data

The mobile map package is available in ArcGIS Online. The map shows rivers in Scotland with unique annotation.

Tags

expiration, mmpk

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<ContentPage x:Class="ArcGISRuntimeXamarin.Samples.HonorMobileMapPackageExpiration.HonorMobileMapPackageExpiration"
             xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:esriUI="clr-namespace:Esri.ArcGISRuntime.Xamarin.Forms;assembly=Esri.ArcGISRuntime.Xamarin.Forms">
    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="auto" />
            <RowDefinition Height="*" />
        </Grid.RowDefinitions>
        <esriUI:MapView x:Name="MyMapView"
                        Grid.Row="0"
                        Grid.RowSpan="2" />
        <Grid Grid.Row="0" BackgroundColor="DarkGray">
            <Label x:Name="ExpirationLabel"
                   Margin="5"
                   Text="Map package not expired."
                   TextColor="White" />
        </Grid>
    </Grid>
</ContentPage>