ResourceOptions

public struct ResourceOptions

extension ResourceOptions: Hashable

extension ResourceOptions: CustomStringConvertible, CustomDebugStringConvertible

Options to configure access to a resource

accessToken
The access token to access the resource. This should be a valid, non-empty, Mapbox access token
Declaration
Swift

public var accessToken: String
baseURL
The base URL. Leave as nil unless you have a reason to change this.
Declaration
Swift

public var baseURL: URL?
dataPathURL
The file URL to the cache. The default, nil, will choose an appropriate location on the device. The default location is excluded from backups.
Declaration
Swift

public var dataPathURL: URL?
assetPathURL
The path to the assets. The default, nil, uses the main bundle.
Declaration
Swift

public var assetPathURL: URL?
tileStore
The tile store instance

This setting can be applied only if tile store usage is enabled, otherwise it is ignored.

If not set and tile store usage is enabled, a tile store at the default location will be created and used.
Attention

If you create a ResourceOptions (rather than using ResourceOptionsManager to manage one) that uses a custom TileStore, you will need to ensure that the TileStore is initialized with a valid access token.

For example:

tileStore.setOptionForKey(TileStoreOptions.mapboxAccessToken, value: accessToken)
Declaration
Swift

public var tileStore: TileStore?
tileStoreUsageMode
Tile store usage mode
Declaration
Swift

public var tileStoreUsageMode: TileStoreUsageMode


                    
                    
                    init(accessToken:baseURL:dataPathURL:assetPathURL:tileStore:tileStoreUsageMode:)

Initialize a ResourceOptions, used by both MapViews and Snapshotters

Attention

If tileStoreUsageMode is .readonly (the default): Tile loading first checks the tile store when requesting a tile: If a tile pack is already loaded, the tile will be extracted and returned. Otherwise, the implementation falls back to requesting the individual tile and storing it in the disk cache.

If tileStoreUsageMode is .readAndUpdate: All tile requests are converted to tile pack requests, i.e. the tile pack that includes the requested tile will be loaded, and the tile extracted from it. In this mode, no individual tile requests will be made.

This mode can be useful if the map trajectory is predefined and the user cannot pan freely (e.g. navigation use cases), so that there is a good chance tile packs are already loaded in the vicinity of the user.

If users can pan freely, this mode is not recommended. Otherwise, panning will download tile packs instead of using individual tiles. Note that this means that we could first download an individual tile, and then a tile pack that also includes this tile. The individual tile in the disk cache won’t be used as long as the up-to-date tile pack exists in the cache.

Declaration

Swift

public init(accessToken: String,
            baseURL: URL? = nil,
            dataPathURL: URL? = nil,
            assetPathURL: URL? = nil,
            tileStore: TileStore? = nil,
            tileStoreUsageMode: TileStoreUsageMode = .readOnly)

Parameters

`accessToken`	Mapbox access token. You must provide a valid token.
`baseUrl`	Base url for resource requests; default is `nil`
`dataPathURL`	Path to database cache; default is `nil`, which will create a path in a suitable application directory that is excluded from backups.
`assetPathURL`	Path to assets; default is `nil`, which will use the application’s resource bundle. `assetPath` is expected to be path to a bundle.
`tileStore`	A tile store is only used if `tileStoreEnabled` is `true`, otherwise this argument is ignored. If `nil` (and `tileStoreEnabled` is `true`, the a default tile store will be created and used.
`tileStoreUsageMode`	Enables or disables tile store usage.