Offline Maps

An object conforming to the VBDOfflineRegion protocol determines which resources are required by an VBDOfflinePack object. At present, only instances of VBDTilePyramidOfflineRegion may be used as VBDOfflinePack regions, but additional conforming implementations may be added in the future.

VBDOfflineStorage implements a singleton (shared object) that manages offline packs. All of this class’s instance methods are asynchronous, reflecting the fact that offline resources are stored in a database. The shared object maintains a canonical collection of offline packs in its packs property.

A block to be called once an offline pack has been completely created and added.

An application typically calls the -resume method on the pack inside this completion handler to begin the download.

Posted by the shared VBDOfflineStorage object whenever an VBDOfflinePack object encounters an error while downloading. The error may be recoverable and may not warrant the user’s attention. For example, the pack’s implementation may attempt to re-request failed resources based on an exponential backoff strategy or upon the restoration of network access.

The object is the VBDOfflinePack object that encountered the error. The userInfo dictionary contains the error object in the VBDOfflinePackErrorUserInfoKey key.

The key for an NSError object that is encountered in the course of downloading an offline pack. This key is used in the userInfo dictionary of an VBDOfflinePackErrorNotification notification. The error’s domain is VBDErrorDomain. See VBDErrorCode for possible error codes.

The key for an NSNumber object that indicates the maximum number of Vietbando-hosted tiles that may be downloaded and stored on the current device. This key is used in the userInfo dictionary of an VBDOfflinePackMaximumVietbandoTilesReachedNotification notification. Call -unsignedLongLongValue on the object to receive the uint64_t-typed tile limit.

Posted by the shared VBDOfflineStorage object when the maximum number of Vietbando-hosted tiles has been downloaded and stored on the current device.

The object is the VBDOfflinePack object that reached the tile limit in the course of downloading. The userInfo dictionary contains the tile limit in the VBDOfflinePackMaximumCountUserInfoKey key.

Once this limit is reached, no instance of VBDOfflinePack can download additional tiles from Vietbando APIs until already downloaded tiles are removed by calling the -[VBDOfflineStorage removePack:withCompletionHandler:] method. Contact your Vietbando sales representative to have the limit raised.

Posted by the shared VBDOfflineStorage object when an VBDOfflinePack object’s progress changes. The progress may change due to a resource being downloaded or because the pack discovers during the download that more resources are required for offline viewing. This notification is posted whenever any field in the progress property changes.

The object is the VBDOfflinePack object whose progress changed. The userInfo dictionary contains the pack’s current state in the VBDOfflinePackStateUserInfoKey key and details about the pack’s current progress in the VBDOfflinePackProgressUserInfoKey key. You may also consult the pack’s state and progress properties, which provide the same values.

If you only need to observe changes in a particular pack’s progress, you can alternatively observe KVO change notifications to the pack’s progress key path.

The key for an NSValue object that indicates an offline pack’s current progress. This key is used in the userInfo dictionary of an VBDOfflinePackProgressChangedNotification notification. Call -VBDOfflinePackProgressValue on the object to receive the VBDOfflinePackProgress-typed progress.

A block to be called once an offline pack has been completely invalidated and removed.

Avoid any references to the pack inside this completion handler: by the time this completion handler is executed, the pack has become invalid, and any messages passed to it will raise an exception.

The key for an NSNumber object that indicates an offline pack’s current state. This key is used in the userInfo dictionary of an VBDOfflinePackProgressChangedNotification notification. Call -integerValue on the object to receive the VBDOfflinePackState-typed state.

An VBDOfflinePack represents a collection of resources necessary for viewing a region offline to a local database.

To create an instance of VBDOfflinePack, use the +[VBDOfflineStorage addPackForRegion:withContext:completionHandler:] method. A pack created using -[VBDOfflinePack init] is immediately invalid.

A structure containing information about an offline pack’s current download progress.

The state an offline pack is currently in.

An offline region defined by a style URL, geographic coordinate bounds, and range of zoom levels.