Module com.esri.arcgisruntime

Package com.esri.arcgisruntime.tasks.offlinemap

Class DownloadPreplannedOfflineMapJob

java.lang.Object

com.esri.arcgisruntime.concurrent.Job

com.esri.arcgisruntime.tasks.offlinemap.DownloadPreplannedOfflineMapJob

All Implemented Interfaces:

JsonSerializable, RemoteResource

public final class DownloadPreplannedOfflineMapJob
extends Job

A job to download an offline map area from an online map as part of the preplanned offline workflow.

Use this job to download the map content of a map area to your device so that you can work offline without a network connection. Upon completion, the job's DownloadPreplannedOfflineMapResult provides the offline map along with the details of any errors that occurred during the download process.

A DownloadPreplannedOfflineMapJob instance is returned by OfflineMapTask.downloadPreplannedOfflineMap(DownloadPreplannedOfflineMapParameters, String). The Job is returned in a Status.NOT_STARTED state and Job.start() must be called to start the associated operation.

See the Job class for full information on how to work with jobs.

Since:

100.2.0

Nested Class Summary

Nested classes/interfaces inherited from class com.esri.arcgisruntime.concurrent.Job

Job.Message, Job.MessageSeverity, Job.MessageSource, Job.Status

Field Summary

Fields inherited from class com.esri.arcgisruntime.concurrent.Job

mCredential, mRequestConfiguration

Method Summary

Modifier and Type	Method	Description
String	getDownloadDirectoryPath()	Gets the download directory path used by this job.
ArcGISMap	getOnlineMap()	Gets the online map used by this job.
DownloadPreplannedOfflineMapParameters	getParameters()	Gets the preplanned parameters used to create this job.
DownloadPreplannedOfflineMapResult	getResult()	Returns a DownloadPreplannedOfflineMapResult once the job has completed.

Methods inherited from class com.esri.arcgisruntime.concurrent.Job

addJobDoneListener, addJobMessageAddedListener, addProgressChangedListener, addStatusChangedListener, cancelAsync, fromJson, getCredential, getError, getMessages, getProgress, getRequestConfiguration, getServerJobId, getStatus, getUnknownJson, getUnsupportedJson, getUri, pause, removeJobDoneListener, removeJobMessageAddedListener, removeProgressChangedListener, removeStatusChangedListener, setCredential, setRequestConfiguration, start, toJson

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

getDownloadDirectoryPath

public String getDownloadDirectoryPath()

Gets the download directory path used by this job. This is the folder in which the resultant mobile map package is stored.

The directory path is the path that was supplied as a parameter to the OfflineMapTask.downloadPreplannedOfflineMap(DownloadPreplannedOfflineMapParameters, String). The job will fail if the last directory in the path cannot be created or is not empty.

Returns:

the directory path to the location of the mobile map package

Since:

100.2.0

getOnlineMap

public ArcGISMap getOnlineMap()

Gets the online map used by this job.

Returns:

the online map used by this job

Since:

100.2.0

getParameters

public DownloadPreplannedOfflineMapParameters getParameters()

Gets the preplanned parameters used to create this job.

Returns:

the preplanned map parameters used to create this job

Since:

100.4.0

getResult

public DownloadPreplannedOfflineMapResult getResult()

Returns a DownloadPreplannedOfflineMapResult once the job has completed. The methods of DownloadPreplannedOfflineMapResult indicate if there were errors related to any layers or tables within the map.

Specified by:

getResult in class Job

Returns:

a DownloadPreplannedOfflineMapResult containing the result, or null if the job is not done yet or was cancelled

Since:

100.2.0

See Also:

• DownloadPreplannedOfflineMapResult.hasErrors()
• DownloadPreplannedOfflineMapResult.getLayerErrors()
• DownloadPreplannedOfflineMapResult.getTableErrors()