com.mapbox.mapboxsdk.offline

Class OfflineRegion

java.lang.Object

com.mapbox.mapboxsdk.offline.OfflineRegion

public class OfflineRegion
extends java.lang.Object

An offline region is the basic building block for offline mobile maps. Use OfflineManager.CreateOfflineRegionCallback to create a new offline region.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	OfflineRegion.DownloadState A region is either inactive (not downloading, but previously-downloaded resources are available for use), or active (resources are being downloaded or will be downloaded, if necessary, when network access is available).
static interface	OfflineRegion.OfflineRegionDeleteCallback This callback receives an asynchronous response containing a notification when an offline region has been deleted, or a String error message otherwise.
static interface	OfflineRegion.OfflineRegionObserver A region can have a single observer, which gets notified whenever a change to the region's status occurs.
static interface	OfflineRegion.OfflineRegionStatusCallback This callback receives an asynchronous response containing the OfflineRegionStatus of the offline region, or a String error message otherwise.

Field Summary

Fields

Modifier and Type	Field and Description
static int	STATE_ACTIVE
static int	STATE_INACTIVE

Method Summary

Modifier and Type	Method and Description
void	delete(OfflineRegion.OfflineRegionDeleteCallback callback) Remove an offline region from the database and perform any resources evictions necessary as a result.
protected void	finalize()
OfflineRegionDefinition	getDefinition()
long	getID()
byte[]	getMetadata()
void	getStatus(OfflineRegion.OfflineRegionStatusCallback callback) Retrieve the current status of the region.
boolean	isDeliveringInactiveMessages() Gets whether or not the `OfflineRegionObserver` will continue to deliver messages even if the region state has been set as STATE_INACTIVE.
void	setDeliverInactiveMessages(boolean deliverInactiveMessages) When set true, the `OfflineRegionObserver` will continue to deliver messages even if the region state has been set as STATE_INACTIVE (operations happen asynchronously).
void	setDownloadState(int state) Pause or resume downloading of regional resources.
void	setObserver(OfflineRegion.OfflineRegionObserver observer) Register an observer to be notified when the state of the region changes.

Methods inherited from class java.lang.Object

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

Field Detail

STATE_INACTIVE

public static final int STATE_INACTIVE

See Also:

Constant Field Values

STATE_ACTIVE

public static final int STATE_ACTIVE

See Also:

Constant Field Values

Method Detail

isDeliveringInactiveMessages

public boolean isDeliveringInactiveMessages()

Gets whether or not the `OfflineRegionObserver` will continue to deliver messages even if the region state has been set as STATE_INACTIVE.

setDeliverInactiveMessages

public void setDeliverInactiveMessages(boolean deliverInactiveMessages)

When set true, the `OfflineRegionObserver` will continue to deliver messages even if the region state has been set as STATE_INACTIVE (operations happen asynchronously). If set false, the client won't be notified of further messages.

getID

public long getID()

getDefinition

public OfflineRegionDefinition getDefinition()

getMetadata

public byte[] getMetadata()

setObserver

public void setObserver(OfflineRegion.OfflineRegionObserver observer)

Register an observer to be notified when the state of the region changes.

setDownloadState

public void setDownloadState(int state)

Pause or resume downloading of regional resources.

getStatus

public void getStatus(OfflineRegion.OfflineRegionStatusCallback callback)

Retrieve the current status of the region. The query will be executed asynchronously and the results passed to the given callback which will be executed on the main thread.

delete

public void delete(OfflineRegion.OfflineRegionDeleteCallback callback)

Remove an offline region from the database and perform any resources evictions necessary as a result. Eviction works by removing the least-recently requested resources not also required by other regions, until the database shrinks below a certain size. When the operation is complete or encounters an error, the given callback will be executed on the main thread. After you call this method, you may not call any additional methods on this object.

finalize

protected void finalize()

Overrides:

finalize in class java.lang.Object