Overview
An advanced marker is an icon placed at a particular point on the map's surface.
Inherits GMSMarker.
Static Public Member Functions | |
| (instancetype) | + markerWithPosition: |
| Convenience constructor for a default marker. | |
| (UIImage *) | + markerImageWithColor: |
| Creates a tinted version of the default marker image for use as an icon. | |
Properties | |
| GMSCollisionBehavior | collisionBehavior |
| The marker's collision behavior, which determines whether or not the marker's visibility can be affected by other markers or labeled content on the map. | |
| CLLocationCoordinate2D | position |
| Marker position. | |
| NSString * | snippet |
| Snippet text, shown beneath the title in the info window when selected. | |
| UIImage * | icon |
| Marker icon to render. | |
| UIView * | iconView |
| Marker view to render. | |
| BOOL | tracksViewChanges |
| Controls whether the icon for this marker should be redrawn every frame. | |
| BOOL | tracksInfoWindowChanges |
| Controls whether the info window for this marker should be redrawn every frame. | |
| CGPoint | groundAnchor |
| The ground anchor specifies the point in the icon image that is anchored to the marker's position on the Earth's surface. | |
| CGPoint | infoWindowAnchor |
| The info window anchor specifies the point in the icon image at which to anchor the info window, which will be displayed directly above this point. | |
| GMSMarkerAnimation | appearAnimation |
| Controls the animation used when this marker is placed on a GMSMapView (default kGMSMarkerAnimationNone, no animation). | |
| BOOL | draggable |
| Controls whether this marker can be dragged interactively (default NO). | |
| BOOL | flat |
| Controls whether this marker should be flat against the Earth's surface (YES) or a billboard facing the camera (NO, default). | |
| CLLocationDegrees | rotation |
| Sets the rotation of the marker in degrees clockwise about the marker's anchor point. | |
| float | opacity |
| Sets the opacity of the marker, between 0 (completely transparent) and 1 (default) inclusive. | |
| GMSMarkerLayer * | layer |
| Provides the Core Animation layer for this GMSMarker. | |
| GMSPanoramaView * | panoramaView |
The panoramaView specifies which panorama view will attempt to show this marker. | |
| NSString * | title |
| Title, a short description of the overlay. | |
| GMSMapView * | map |
| The map this overlay is on. | |
| BOOL | tappable |
| If this overlay should cause tap notifications. | |
| int | zIndex |
Higher zIndex value overlays will be drawn on top of lower zIndex value tile layers and overlays. | |
| id | userData |
| Overlay data. | |
Member Function Documentation
| + (instancetype) markerWithPosition: | (CLLocationCoordinate2D) | position |
Convenience constructor for a default marker.
| + (UIImage *) markerImageWithColor: | (nullable UIColor *) | color |
Creates a tinted version of the default marker image for use as an icon.
Property Documentation
- (GMSCollisionBehavior) collisionBehavior [read, write, assign] |
The marker's collision behavior, which determines whether or not the marker's visibility can be affected by other markers or labeled content on the map.
- (CLLocationCoordinate2D) position [read, write, assign, inherited] |
Marker position.
Animated.
- (NSString*) snippet [read, write, copy, inherited] |
Snippet text, shown beneath the title in the info window when selected.
- (UIImage*) icon [read, write, assign, inherited] |
Marker icon to render.
If left nil, uses a default SDK place marker.
Supports animated images, but each frame must be the same size or the behavior is undefined.
Supports the use of alignmentRectInsets to specify a reduced tap area. This also redefines how anchors are specified. For an animated image the value for the animation is used, not the individual frames.
- (UIView*) iconView [read, write, assign, inherited] |
Marker view to render.
If left nil, falls back to the icon property instead.
Supports animation of all animatable properties of UIView, except frame and center. Changing these properties or their corresponding CALayer version, including position, is not supported.
Note that the view behaves as if clipsToBounds is set to YES, regardless of its actual value.
- (BOOL) tracksViewChanges [read, write, assign, inherited] |
Controls whether the icon for this marker should be redrawn every frame.
Note that when this changes from NO to YES, the icon is guaranteed to be redrawn next frame.
Defaults to YES. Has no effect if iconView is nil.
- (BOOL) tracksInfoWindowChanges [read, write, assign, inherited] |
Controls whether the info window for this marker should be redrawn every frame.
Note that when this changes from NO to YES, the info window is guaranteed to be redrawn next frame.
Defaults to NO.
- (CGPoint) groundAnchor [read, write, assign, inherited] |
The ground anchor specifies the point in the icon image that is anchored to the marker's position on the Earth's surface.
This point is specified within the continuous space [0.0, 1.0] x [0.0, 1.0], where (0,0) is the top-left corner of the image, and (1,1) is the bottom-right corner.
If the image has non-zero alignmentRectInsets, the top-left and bottom-right mentioned above refer to the inset section of the image.
- (CGPoint) infoWindowAnchor [read, write, assign, inherited] |
The info window anchor specifies the point in the icon image at which to anchor the info window, which will be displayed directly above this point.
This point is specified within the same space as groundAnchor.
- (GMSMarkerAnimation) appearAnimation [read, write, assign, inherited] |
Controls the animation used when this marker is placed on a GMSMapView (default kGMSMarkerAnimationNone, no animation).
- (BOOL) draggable [read, write, assign, inherited] |
Controls whether this marker can be dragged interactively (default NO).
- (BOOL) flat [read, write, assign, inherited] |
Controls whether this marker should be flat against the Earth's surface (YES) or a billboard facing the camera (NO, default).
- (CLLocationDegrees) rotation [read, write, assign, inherited] |
Sets the rotation of the marker in degrees clockwise about the marker's anchor point.
The axis of rotation is perpendicular to the marker. A rotation of 0 corresponds to the default position of the marker. Animated.
When the marker is flat on the map, the default position is north aligned and the rotation is such that the marker always remains flat on the map. When the marker is a billboard, the default position is pointing up and the rotation is such that the marker is always facing the camera.
- (float) opacity [read, write, assign, inherited] |
Sets the opacity of the marker, between 0 (completely transparent) and 1 (default) inclusive.
- (GMSMarkerLayer*) layer [read, assign, inherited] |
Provides the Core Animation layer for this GMSMarker.
- (GMSPanoramaView*) panoramaView [read, write, assign, inherited] |
The panoramaView specifies which panorama view will attempt to show this marker.
Note that if the marker's position is too far away from the panoramaView's current panorama location, it will not be displayed as it will be too small.
Can be set to nil to remove the marker from any current panorama view it is attached to.
A marker can be shown on both a panorama and a map at the same time.
- (NSString*) title [read, write, copy, inherited] |
Title, a short description of the overlay.
Some overlays, such as markers, will display the title on the map. The title is also the default accessibility text.
- (GMSMapView*) map [read, write, assign, inherited] |
The map this overlay is on.
Setting this property will add the overlay to the map. Setting it to nil removes this overlay from the map. An overlay may be active on at most one map at any given time.
- (BOOL) tappable [read, write, assign, inherited] |
If this overlay should cause tap notifications.
Some overlays, such as markers, will default to being tappable.
- (int) zIndex [read, write, assign, inherited] |
Higher zIndex value overlays will be drawn on top of lower zIndex value tile layers and overlays.
Equal values result in undefined draw ordering. Markers are an exception that regardless of zIndex, they will always be drawn above tile layers and other non-marker overlays; they are effectively considered to be in a separate z-index group compared to other overlays.
- (id) userData [read, write, assign, inherited] |
Overlay data.
You can use this property to associate an arbitrary object with this overlay. Google Maps SDK for iOS neither reads nor writes this property.
Note that userData should not hold any strong references to any Maps objects, otherwise a retain cycle may be created (preventing objects from being released).