MGLStyle
@interface MGLStyle : NSObject
The proxy object for the current map style for customization purposes and a set of convenience methods for creating style URLs of default styles provided by Mapbox. Learn more about Mapbox default styles.
-
Returns the URL to version 8 of the Mapbox Streets style.
Streets is a general-purpose style with detailed road and transit networks.
MGLMapView
andMGLTilePyramidOfflineRegion
use Mapbox Streets when no style is specified explicitly.Declaration
Objective-C
+ (nonnull NSURL *)streetsStyleURL;
Swift
class func streetsStyleURL() -> URL
-
Returns the URL to the given version of the Mapbox Streets style.
Streets is a general-purpose style with detailed road and transit networks.
MGLMapView
andMGLTilePyramidOfflineRegion
use Mapbox Streets when no style is specified explicitly.Declaration
Objective-C
+ (nonnull NSURL *)streetsStyleURLWithVersion:(NSInteger)version;
Swift
class func streetsStyleURL(withVersion version: Int) -> URL
Parameters
version
The style’s latest released version. As of publication, the current version is
9
. -
Returns the URL to version 8 of the Mapbox Emerald style.
Emerald is a tactile style with subtle textures and dramatic hillshading.
Declaration
Objective-C
+ (nonnull NSURL *)emeraldStyleURL;
Swift
class func emeraldStyleURL() -> URL
-
Returns the URL to the given version of the Mapbox Outdoors style.
Outdoors is a general-purpose style tailored to outdoor activities.
Declaration
Objective-C
+ (nonnull NSURL *)outdoorsStyleURLWithVersion:(NSInteger)version;
Swift
class func outdoorsStyleURL(withVersion version: Int) -> URL
Parameters
version
The style’s latest released version. As of publication, the current version is
9
. -
Returns the URL to version 8 of the Mapbox Light style.
Light is a subtle, light-colored backdrop for data visualizations.
Declaration
Objective-C
+ (nonnull NSURL *)lightStyleURL;
Swift
class func lightStyleURL() -> URL
-
Returns the URL to the given version of the Mapbox Light style.
Light is a subtle, light-colored backdrop for data visualizations.
Declaration
Objective-C
+ (nonnull NSURL *)lightStyleURLWithVersion:(NSInteger)version;
Swift
class func lightStyleURL(withVersion version: Int) -> URL
Parameters
version
The style’s latest released version. As of publication, the current version is
9
. -
Returns the URL to version 8 of the Mapbox Dark style.
Dark is a subtle, dark-colored backdrop for data visualizations.
Declaration
Objective-C
+ (nonnull NSURL *)darkStyleURL;
Swift
class func darkStyleURL() -> URL
-
Returns the URL to the given version of the Mapbox Dark style.
Dark is a subtle, dark-colored backdrop for data visualizations.
Declaration
Objective-C
+ (nonnull NSURL *)darkStyleURLWithVersion:(NSInteger)version;
Swift
class func darkStyleURL(withVersion version: Int) -> URL
Parameters
version
The style’s latest released version. As of publication, the current version is
9
. -
Returns the URL to version 8 of the Mapbox Satellite style.
Satellite is high-resolution satellite and aerial imagery.
Declaration
Objective-C
+ (nonnull NSURL *)satelliteStyleURL;
Swift
class func satelliteStyleURL() -> URL
-
Returns the URL to the given version of the Mapbox Satellite style.
Satellite is high-resolution satellite and aerial imagery.
Declaration
Objective-C
+ (nonnull NSURL *)satelliteStyleURLWithVersion:(NSInteger)version;
Swift
class func satelliteStyleURL(withVersion version: Int) -> URL
Parameters
version
The style’s latest released version. As of publication, the current version is
9
. -
Returns the URL to version 8 of the Mapbox Satellite Streets style.
Satellite Streets combines the high-resolution satellite and aerial imagery of Mapbox Satellite with unobtrusive labels and translucent roads from Mapbox Streets.
Declaration
Objective-C
+ (nonnull NSURL *)hybridStyleURL;
Swift
class func hybridStyleURL() -> URL
-
Returns the URL to the given version of the Mapbox Satellite Streets style.
Satellite Streets combines the high-resolution satellite and aerial imagery of Mapbox Satellite with unobtrusive labels and translucent roads from Mapbox Streets.
Declaration
Objective-C
+ (nonnull NSURL *)satelliteStreetsStyleURLWithVersion:(NSInteger)version;
Swift
class func satelliteStreetsStyleURL(withVersion version: Int) -> URL
Parameters
version
The style’s latest released version. As of publication, the current version is
9
. -
The name of the style.
You can customize the style’s name in Mapbox Studio.
Declaration
Objective-C
@property (readonly, copy, atomic, nullable) NSString *name;
Swift
var name: String? { get }
-
Returns a layer that conforms to
MGLStyleLayer
if any layer with the given identifier was found.Declaration
Objective-C
- (nullable id<MGLStyleLayer>)layerWithIdentifier: (nonnull NSString *)identifier;
Swift
func layer(withIdentifier identifier: String) -> MGLStyleLayer?
Return Value
layer A layer instance of the corresponding type.
-
Adds a new layer on top of existing layers.
Declaration
Objective-C
- (void)addLayer:(nonnull id<MGLStyleLayer>)styleLayer;
Swift
func add(_ styleLayer: MGLStyleLayer)
Parameters
styleLayer
The layer object to add to the map view. This object must conform to the
MGLStyleLayer
protocol. -
Inserts a new layer below another layer.
Declaration
Objective-C
- (void)insertLayer:(nonnull id<MGLStyleLayer>)styleLayer belowLayer:(nonnull id<MGLStyleLayer>)belowLayer;
Swift
func insert(_ styleLayer: MGLStyleLayer, below belowLayer: MGLStyleLayer)
Parameters
styleLayer
Layer to be inserted.
belowLayer
A layer that’s already on the map view.
-
Removes a layer from the map view.
Declaration
Objective-C
- (void)removeLayer:(nonnull id<MGLStyleLayer>)styleLayer;
Swift
func remove(_ styleLayer: MGLStyleLayer)
Parameters
styleLayer
The layer object to remove from the map view. This object must conform to the
MGLStyleLayer
protocol. -
Currently active style classes, represented as an array of string identifiers.
Declaration
Objective-C
@property (assign, readwrite, nonatomic) NSArray<NSString *> *_Nonnull styleClasses;
Swift
var styleClasses: [String] { get set }
-
Returns a Boolean value indicating whether the style class with the given identifier is currently active.
Declaration
Objective-C
- (BOOL)hasStyleClass:(nonnull NSString *)styleClass;
Swift
func hasStyleClass(_ styleClass: String) -> Bool
Parameters
styleClass
The style class to query for.
Return Value
Whether the style class is currently active.
-
Activates the style class with the given identifier.
Declaration
Objective-C
- (void)addStyleClass:(nonnull NSString *)styleClass;
Swift
func addClass(_ styleClass: String)
Parameters
styleClass
The style class to activate.
-
Deactivates the style class with the given identifier.
Declaration
Objective-C
- (void)removeStyleClass:(nonnull NSString *)styleClass;
Swift
func removeStyleClass(_ styleClass: String)
Parameters
styleClass
The style class to deactivate.