MGLCircleStyleLayer
@interface MGLCircleStyleLayer : MGLVectorStyleLayer
An MGLCircleStyleLayer
is a style layer that renders one or more filled
circles on the map.
Use a circle style layer to configure the visual appearance of point or point
collection features in vector tiles loaded by an MGLVectorSource
object or
MGLPointAnnotation
, MGLPointFeature
, MGLPointCollection
, or
MGLPointCollectionFeature
instances in an MGLShapeSource
object.
A circle style layer renders circles whose radii are measured in screen units.
To display circles on the map whose radii correspond to real-world distances,
use many-sided regular polygons and configure their appearance using an
MGLFillStyleLayer
object.
You can access an existing circle style layer using the
-[MGLStyle layerWithIdentifier:]
method if you know its identifier;
otherwise, find it using the MGLStyle.layers
property. You can also create a
new circle style layer and add it to the style using a method such as
-[MGLStyle addLayer:]
.
Example
let layer = MGLCircleStyleLayer(identifier: circles
, source: population)
layer.sourceLayerIdentifier = population
layer.circleColor = MGLStyleValue(rawValue: UIColor.green)
layer.circleRadius = MGLStyleValue(interpolationBase: 1.75, stops: [
12: MGLStyleValue(rawValue: 2),
22: MGLStyleValue(rawValue: 180)
])
layer.circleOpacity = MGLStyleValue(rawValue: 0.7)
layer.predicate = NSPredicate(format: %K == %@
, marital-status
, married
)
mapView.style.addLayer(layer)
-
Amount to blur the circle. 1 blurs the circle such that only the centerpoint is full opacity.
The default value of this property is an
MGLStyleValue
object containing anNSNumber
object containing the float0
. Set this property tonil
to reset it to the default value.Declaration
Objective-C
@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSNumber *> *circleBlur;
Swift
var circleBlur: MGLStyleValue
-
The fill color of the circle.
The default value of this property is an
MGLStyleValue
object containingUIColor.blackColor
. Set this property tonil
to reset it to the default value.Declaration
Objective-C
@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<UIColor *> *circleColor;
Swift
var circleColor: MGLStyleValue
-
The opacity at which the circle will be drawn.
The default value of this property is an
MGLStyleValue
object containing anNSNumber
object containing the float1
. Set this property tonil
to reset it to the default value.Declaration
Objective-C
@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSNumber *> *circleOpacity;
Swift
var circleOpacity: MGLStyleValue
-
Controls the scaling behavior of the circle when the map is pitched.
The default value of this property is an
MGLStyleValue
object containing anNSValue
object containingMGLCirclePitchScaleMap
. Set this property tonil
to reset it to the default value.Declaration
Objective-C
@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSValue *> *circlePitchScale;
Swift
var circlePitchScale: MGLStyleValue
-
Circle radius.
This property is measured in points.
The default value of this property is an
MGLStyleValue
object containing anNSNumber
object containing the float5
. Set this property tonil
to reset it to the default value.Declaration
Objective-C
@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSNumber *> *circleRadius;
Swift
var circleRadius: MGLStyleValue
-
The geometry’s offset.
This property is measured in points.
The default value of this property is an
MGLStyleValue
object containing anNSValue
object containing aCGVector
struct set to 0 points from the left and 0 points from the top. Set this property tonil
to reset it to the default value.Declaration
Objective-C
@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSValue *> *circleTranslate;
Swift
var circleTranslate: MGLStyleValue
-
Controls the translation reference point.
The default value of this property is an
MGLStyleValue
object containing anNSValue
object containingMGLCircleTranslateAnchorMap
. Set this property tonil
to reset it to the default value.This property is only applied to the style if
circleTranslate
is non-nil
. Otherwise, it is ignored.Declaration
Objective-C
@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSValue *> *circleTranslateAnchor;
Swift
var circleTranslateAnchor: MGLStyleValue