MGLOfflineStorage

Returns the shared offline storage object.

The receiver’s delegate.

An offline storage object sends messages to its delegate to allow it to transform URLs before they are requested from the internet. This can be used add or remove custom parameters, or reroute certain requests to other servers or endpoints.

The file path at which offline packs and the ambient cache are stored.

To customize this path, specify the MGLOfflineStorageDatabasePath key in Info.plist.

The file URL at which offline packs and the ambient cache are stored.

To customize this path, specify the MGLOfflineStorageDatabasePath key in Info.plist.

Adds the offline packs located at the given file path to offline storage.

The file must be a valid offline pack database bundled with the application or downloaded separately.

The resulting packs are added or updated to the shared offline storage object’s packs property, then the completion block is executed.

Adds the offline packs located at the given URL to offline storage.

The file must be a valid offline pack database bundled with the application or downloaded separately.

The resulting packs are added or updated to the shared offline storage object’s packs property, then the completion block is executed.

An array of all known offline packs, in the order in which they were created.

This property is set to nil, indicating that the receiver does not yet know the existing packs, for an undefined amount of time starting from the moment the shared offline storage object is initialized until the packs are fetched from the database. After that point, this property is always non-nil, but it may be empty to indicate that no packs are present.

To detect when the shared offline storage object has finished loading its packs property, observe KVO change notifications on the packs key path. The initial load results in an NSKeyValueChangeSetting change.

Creates and registers an offline pack that downloads the resources needed to use the given region offline.

The resulting pack is added to the shared offline storage object’s packs property, then the completion block is executed with that pack passed in.

The pack has an initial state of MGLOfflinePackStateInactive. To begin downloading resources, call -[MGLOfflinePack resume] on the pack from within the completion handler. To monitor download progress, add an observer for MGLOfflinePackProgressChangedNotifications about that pack.

To detect when any call to this method results in a new pack, observe KVO change notifications on the shared offline storage object’s packs key path. Additions to that array result in an NSKeyValueChangeInsertion change.

Unregisters the given offline pack and allows resources that are no longer required by any remaining packs to be potentially freed.

As soon as this method is called on a pack, the pack becomes invalid; any attempt to send it a message will result in an exception being thrown. If an error occurs and the pack cannot be removed, do not attempt to reuse the pack object. Instead, if you need continued access to the pack, suspend all packs and use the -reloadPacks method to obtain valid pointers to all the packs.

To detect when any call to this method results in a pack being removed, observe KVO change notifications on the shared offline storage object’s packs key path. Removals from that array result in an NSKeyValueChangeRemoval change.

When you remove an offline pack, any resources that are required by that pack, but not other packs, become eligible for deletion from offline storage. Because the backing store used for offline storage is also used as a general purpose cache for map resources, such resources may not be immediately removed if the implementation determines that they remain useful for general performance of the map.

Invalidates the specified offline pack. This method checks that the tiles in the specified offline pack match those from the server. Local tiles that do not match the latest version on the server are updated.

This is more efficient than deleting the offline pack and downloading it again. If the data stored locally matches that on the server, new data will not be downloaded.

Forcibly, asynchronously reloads the packs property. At some point after this method is called, the pointer values of the MGLOfflinePack objects in the packs property change, even if the underlying data for these packs has not changed. If this method is called while a pack is actively downloading, the behavior is undefined.

You typically do not need to call this method.

To detect when the shared offline storage object has finished reloading its packs property, observe KVO change notifications on the packs key path. A reload results in an NSKeyValueChangeSetting change.

Sets the maximum number of Mapbox-hosted tiles that may be downloaded and stored on the current device.

Once this limit is reached, an MGLOfflinePackMaximumMapboxTilesReachedNotification is posted for every attempt to download additional tiles until already downloaded tiles are removed by calling the -removePack:withCompletionHandler: method.

The cumulative size, measured in bytes, of all downloaded resources on disk.

The returned value includes all resources, including tiles, whether downloaded as part of an offline pack or due to caching during normal use of MGLMapView.

Sets the maximum ambient cache size in bytes. The default maximum cache size is 50 MB. To disable ambient caching, set the maximum ambient cache size to 0. Setting the maximum ambient cache size does not impact the maximum size of offline packs.

This method does not limit the space available to offline packs, and data in offline packs does not count towards this limit. If you set the maximum ambient cache size to 30 MB then download 20 MB of offline packs, 30 MB will remain available for the ambient cache.

This method should be called before the map and map style have been loaded.

This method is potentially expensive, as the database will trim cached data in order to prevent the ambient cache from being larger than the specified amount.

Invalidates the ambient cache. This method checks that the tiles in the ambient cache match those from the server. If the local tiles do not match those on the server, they are re-downloaded.

This is recommended over clearing the cache or resetting the database because valid local tiles will not be downloaded again.

Resources shared with offline packs will not be affected by this method.

Clears the ambient cache by deleting resources. This method does not affect resources shared with offline regions.

Deletes the existing database, which includes both the ambient cache and offline packs, then reinitializes it.

You typically do not need to call this method.

Inserts the provided resource into the ambient cache.

This method mimics the caching that would take place if the equivalent resource were requested in the process of map rendering. Use this method to pre-warm the cache with resources you know will be requested.

This method is asynchronous; the data may not be immediately available for in-progress requests, though subsequent requests should have access to the cached data.

To find out when the resource is ready to retrieve from the cache, use the -preloadData:forURL:modificationDate:expirationDate:eTag:mustRevalidate:completionHandler: method.

Inserts the provided resource into the ambient cache, calling a completion handler when finished.

This method is asynchronous. The data is available for in-progress requests as soon as the completion handler is called.

This method is asynchronous; the data may not be immediately available for in-progress requests, though subsequent requests should have access to the cached data.