MGLTilePyramidOfflineRegion
@interface MGLTilePyramidOfflineRegion
: NSObject <MGLOfflineRegion, NSSecureCoding, NSCopying>
An offline region defined by a style URL, geographic coordinate bounds, and range of zoom levels.
-
URL of the style whose resources are required for offline viewing.
In addition to the JSON stylesheet, different styles may require different font glyphs, sprite sheets, and other resources.
The URL may be a full HTTP or HTTPS URL or a Mapbox URL indicating the style’s map ID (
mapbox://styles/{user}/{style}
).Declaration
Objective-C
@property (readonly, nonatomic) NSURL *_Nonnull styleURL;
Swift
var styleURL: URL { get }
-
The coordinate bounds for the geographic region covered by the downloaded tiles.
Declaration
Objective-C
@property (readonly, nonatomic) MGLCoordinateBounds bounds;
Swift
var bounds: MGLCoordinateBounds { get }
-
The minimum zoom level for which to download tiles and other resources.
For more information about zoom levels,
-[MGLMapView zoomLevel]
.Declaration
Objective-C
@property (readonly, nonatomic) double minimumZoomLevel;
Swift
var minimumZoomLevel: Double { get }
-
The maximum zoom level for which to download tiles and other resources.
For more information about zoom levels,
-[MGLMapView zoomLevel]
.Declaration
Objective-C
@property (readonly, nonatomic) double maximumZoomLevel;
Swift
var maximumZoomLevel: Double { get }
-
Initializes a newly created offline region with the given style URL, geographic coordinate bounds, and range of zoom levels.
This is the designated initializer for
MGLTilePyramidOfflineRegion
.Declaration
Objective-C
- (nonnull instancetype)initWithStyleURL:(nullable NSURL *)styleURL bounds:(MGLCoordinateBounds)bounds fromZoomLevel:(double)minimumZoomLevel toZoomLevel:(double)maximumZoomLevel;
Swift
init(styleURL: URL?, bounds: MGLCoordinateBounds, fromZoomLevel minimumZoomLevel: Double, toZoomLevel maximumZoomLevel: Double)
Parameters
styleURL
URL of the map style for which to download resources. The URL may be a full HTTP or HTTPS URL or a Mapbox URL indicating the style’s map ID (
mapbox://styles/{user}/{style}
). Specifynil
for the default style. Relative file URLs cannot be used as offline style URLs. To download the online resources required by a local style, specify a URL to an online copy of the style.bounds
The coordinate bounds for the geographic region to be covered by the downloaded tiles.
minimumZoomLevel
The minimum zoom level to be covered by the downloaded tiles. This parameter should be set to at least 0 but no greater than the value of the
maximumZoomLevel
parameter. For each required tile source, if this parameter is set to a value less than the tile source’s minimum zoom level, the download covers zoom levels down to the tile source’s minimum zoom level.maximumZoomLevel
The maximum zoom level to be covered by the downloaded tiles. This parameter should be set to at least the value of the
minimumZoomLevel
parameter. For each required tile source, if this parameter is set to a value greater than the tile source’s minimum zoom level, the download covers zoom levels up to the tile source’s maximum zoom level.