GoogleMaps Framework Reference
Stay organized with collections
Save and categorize content based on your preferences.
GMSCircle
A circle on the Earth’s surface (spherical cap).
-
Position on Earth of circle center. Ignores invalid positions.
Declaration
Swift
var position: CLLocationCoordinate2D { get set }
Objective-C
@property (nonatomic) CLLocationCoordinate2D position;
-
Radius of the circle in meters; must be positive.
Declaration
Swift
var radius: CLLocationDistance { get set }
Objective-C
@property (nonatomic) CLLocationDistance radius;
-
The width of the circle’s outline in screen points. Defaults to 1. As per GMSPolygon
, the width
does not scale when the map is zoomed.
Setting strokeWidth to 0 results in no stroke.
Declaration
Swift
var strokeWidth: CGFloat { get set }
Objective-C
@property (nonatomic) CGFloat strokeWidth;
-
The color of this circle’s outline. The default value is black.
Declaration
Swift
var strokeColor: UIColor? { get set }
Objective-C
@property (nonatomic, nullable) UIColor *strokeColor;
-
The interior of the circle is painted with fillColor. The default value is nil, resulting in no
fill.
Declaration
Swift
var fillColor: UIColor? { get set }
Objective-C
@property (nonatomic, nullable) UIColor *fillColor;
-
Convenience constructor for GMSCircle
for a particular position and radius. Other properties
will have default values. An invalid position will result in an overlay object that cannot be
drawn on the map.
Declaration
Swift
convenience init(position: CLLocationCoordinate2D, radius: CLLocationDistance)
Objective-C
+ (nonnull instancetype)circleWithPosition:(CLLocationCoordinate2D)position
radius:(CLLocationDistance)radius;
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.
[null,null,["Last updated 2025-08-27 UTC."],[[["\u003cp\u003e\u003ccode\u003eGMSCircle\u003c/code\u003e represents a circle on the Earth's surface, defined by its center position and radius.\u003c/p\u003e\n"],["\u003cp\u003eIt can be customized with properties such as stroke width, stroke color, and fill color.\u003c/p\u003e\n"],["\u003cp\u003eStroke width is in screen points and does not scale with map zoom, while a stroke width of 0 results in no stroke.\u003c/p\u003e\n"],["\u003cp\u003eThe default stroke color is black, and the default fill color is nil (transparent), resulting in no fill.\u003c/p\u003e\n"],["\u003cp\u003eA convenience constructor \u003ccode\u003ecircleWithPosition:radius:\u003c/code\u003e allows for easy creation of \u003ccode\u003eGMSCircle\u003c/code\u003e objects.\u003c/p\u003e\n"]]],["GMSCircle defines a circle on Earth with properties for customization. Key actions include setting the `position` (center) and `radius` (in meters). The outline's `strokeWidth` (in screen points) and `strokeColor` can be defined, with a default black outline. The `fillColor` determines the circle's interior color, defaulting to no fill. The `circleWithPosition:radius:` method is a constructor for setting initial position and radius.\n"],null,["# GoogleMaps Framework Reference\n\nGMSCircle\n=========\n\n @interface GMSCircle : ../Classes/GMSOverlay.html\n\nA circle on the Earth's surface (spherical cap).\n- `\n ``\n ``\n `\n\n ### [position](#/c:objc(cs)GMSCircle(py)position)\n\n `\n ` \n Position on Earth of circle center. Ignores invalid positions. \n\n #### Declaration\n\n Swift \n\n var position: CLLocationCoordinate2D { get set }\n\n Objective-C \n\n @property (nonatomic) CLLocationCoordinate2D position;\n\n- `\n ``\n ``\n `\n\n ### [radius](#/c:objc(cs)GMSCircle(py)radius)\n\n `\n ` \n Radius of the circle in meters; must be positive. \n\n #### Declaration\n\n Swift \n\n var radius: CLLocationDistance { get set }\n\n Objective-C \n\n @property (nonatomic) CLLocationDistance radius;\n\n- `\n ``\n ``\n `\n\n ### [strokeWidth](#/c:objc(cs)GMSCircle(py)strokeWidth)\n\n `\n ` \n The width of the circle's outline in screen points. Defaults to 1. As per [GMSPolygon](../Classes/GMSPolygon.html), the width\n does not scale when the map is zoomed.\n\n Setting strokeWidth to 0 results in no stroke. \n\n #### Declaration\n\n Swift \n\n var strokeWidth: CGFloat { get set }\n\n Objective-C \n\n @property (nonatomic) CGFloat strokeWidth;\n\n- `\n ``\n ``\n `\n\n ### [strokeColor](#/c:objc(cs)GMSCircle(py)strokeColor)\n\n `\n ` \n The color of this circle's outline. The default value is black. \n\n #### Declaration\n\n Swift \n\n var strokeColor: UIColor? { get set }\n\n Objective-C \n\n @property (nonatomic, nullable) UIColor *strokeColor;\n\n- `\n ``\n ``\n `\n\n ### [fillColor](#/c:objc(cs)GMSCircle(py)fillColor)\n\n `\n ` \n The interior of the circle is painted with fillColor. The default value is nil, resulting in no\n fill. \n\n #### Declaration\n\n Swift \n\n var fillColor: UIColor? { get set }\n\n Objective-C \n\n @property (nonatomic, nullable) UIColor *fillColor;\n\n- `\n ``\n ``\n `\n\n ### [+circleWithPosition:radius:](#/c:objc(cs)GMSCircle(cm)circleWithPosition:radius:)\n\n `\n ` \n Convenience constructor for `GMSCircle` for a particular position and radius. Other properties\n will have default values. An invalid position will result in an overlay object that cannot be\n drawn on the map. \n\n #### Declaration\n\n Swift \n\n convenience init(position: CLLocationCoordinate2D, radius: CLLocationDistance)\n\n Objective-C \n\n + (nonnull instancetype)circleWithPosition:(CLLocationCoordinate2D)position\n radius:(CLLocationDistance)radius;"]]