Download Preplanned Offline Map Job
A job to download the offline map for an offline map area from a web map that is enabled for offline use and has offline map areas defined. This job is part of the ahead-of-time offline workflow. Use this job to download the offline map to your device so that you can work offline without a network connection. Note that offline map areas may also be referred to as preplanned map areas.
To make a DownloadPreplannedOfflineMapJob, use the OfflineMapTask as follows:
Construct and load the OfflineMapTask with a web map that is enabled for offline use. For more information about enabling web maps for offline use see Take web maps offline.
If necessary, check the web map's offline capabilities by using OfflineMapTask.getOfflineMapCapabilities.
Select an offline map area from the collection of offline map areas returned by OfflineMapTask.getPreplannedMapAreas.
Obtain the default DownloadPreplannedOfflineMapParameters for the offline map area by calling OfflineMapTask.createDefaultDownloadPreplannedOfflineMapParameters.
Adjust any parameters, as required.
Use the DownloadPreplannedOfflineMapParameters to create a DownloadPreplannedOfflineMapJob by calling OfflineMapTask.createDownloadPreplannedOfflineMapJob. You must specify a path to a folder where the map content will be stored on the device.
Start the DownloadPreplannedOfflineMapJob and monitor progress. Upon completion, the job's DownloadPreplannedOfflineMapResult provides the offline map along with the details of any errors incurred during the download process.
See the com.arcgismaps.tasks.Job class for full information on how to work with jobs.
Since
200.1.0
Properties
The directory path to the location of the mobile map package. The directory path is the path that was supplied as a parameter to the OfflineMapTask.createDownloadPreplannedOfflineMapJob. The job will fail if the last directory in the path cannot be created or is not empty.
The preplanned map parameters used to create this job.
Inherited properties
Inherited functions
Cancels this Job and waits for any asynchronous, server-side operations to be canceled. The job is canceled and will result in a JobStatus.Failed status after all cancellation tasks have completed. For jobs running on a server, a cancel request is sent for the associated Job.serverJobId. You should always cancel unneeded jobs (for example when exiting your app) to avoid placing unnecessary load on the server. Examples of server-side jobs include:
Initiates a request to check the server status. If the job is polling the server for status and is in a time gap, then calling this method will ensure a request is sent right away. The result can be false if the job is not checking server status for example if the job status is paused or uploading.
Suspends until this job has completed. Calling this function does not start the job. In order to start the job call start