TilesetDescriptorOptions

extension TilesetDescriptorOptions
  • Initializes a TilesetDescriptorOptions which is used in the creation of a TilesetDescriptor.

    Note

    The implementation loads and stores the loaded tiles in batches, each batch has a pre-defined zoom range and it contains all child tiles within the range. TThe zoom leveling scheme for the tile batches can be defined in Tile JSON, otherwise the default scheme is used:

    • Global coverage: 0 - 5

    • Regional information: 6 - 10

    • Local information: 11 - 14

    • Streets detail: 15 - 16

    Internally, the implementation maps the given tile pack zoom range and geometry to a set of pre-defined batches to load, therefore it is highly recommended to choose the minZoom and maxZoom values in accordance with the tile batches zoom ranges (see the list above).

    Note

    If a stylePackOptions is provided, OfflineManager will create a style package while resolving the corresponding tileset descriptor and load all the resources as defined in the provided style package options, i.e. resolving the corresponding tileset descriptor will be equivalent to calling the loadStylePack() method of OfflineManager.

    If not provided, resolving of the corresponding tileset descriptor will not cause creating of a new style package but the loaded resources will be stored in the disk cache.

    Declaration

    Swift

    public convenience init(styleURI: StyleURI,
                            zoomRange: ClosedRange<UInt8>,
                            pixelRatio: Float = Float(UIScreen.main.scale),
                            stylePackOptions: StylePackLoadOptions? = nil)

    Parameters

    styleURI

    The style associated with the tileset descriptor.

    zoomRange

    Closed range zoom level for the tile package.

    pixelRatio

    Pixel ratio to be accounted for when downloading raster tiles. Typically this should match the scale used by the MapView, most likely UIScreen.main.scale, which is the default value.

    stylePackOptions

    Style package load options, associated with the tileset descriptor.