概览
标记是放置在地图表面的特定点的图标。
标记的图标是相对于设备的屏幕(而非地图表面)绘制的;也就是说,标记不会随着地图旋转、倾斜或缩放而改变方向。
继承 GMSOverlay。
静态公共成员函数 | |
(实例类型) | + markerWithPosition: |
默认标记的便捷构造函数。 | |
(UI 图片 *) | + markerImageWithColor: |
创建默认标记图片的着色版本,以用作图标。 | |
属性 | |
CLLocationCoordinate2D | 职位 |
标记位置。 | |
NSString * | 代码段 |
摘要文字,选择后会显示在信息窗口的标题下方。 | |
UIImage * | 图标 |
要渲染的标记图标。 | |
UIView * | iconView |
要呈现的标记视图。 | |
BOOL | tracksViewChanges |
控制是否应在每帧上重新绘制此标记的图标。 | |
BOOL | tracksInfoWindowChanges |
控制是否应在每帧上重新绘制此标记的信息窗口。 | |
CGPoint | GroundAnchor |
地面锚点用于指定图标图像中的点,该点锚定到地球表面的标记位置。 | |
CGPoint | infoWindowAnchor |
信息窗口锚点指定图标图片中用来锚定信息窗口的点,该点将直接显示在这个点的上方。 | |
GMSMarkerAnimation | 显示动画 |
控制将此标记放在GMSMapView时使用的动画(默认为 kGMSMarkerAnimationNone,无动画)。 | |
BOOL | 可拖动 |
控制是否可以以可交互方式拖动此标记(默认为“否”)。 | |
BOOL | 平面 |
控制该标记是应平贴地球表面 (YES) 还是朝向镜头的广告牌(否、默认)。 | |
CLLocationDegrees | 旋转 |
设置标记围绕标记锚点的顺时针角度(以度为单位)。 | |
浮点数 | 不透明度 |
设置标记的不透明度,介于 0(完全透明)和 1(默认)(含)之间。 | |
GMSMarkerLayer* | 图层 |
为此 GMSMarker 提供核心动画层。 | |
GMSPanoramaView* | PanoramaramaView |
panoramaView ,用于指定尝试显示此标记的全景视图。 | |
NSString * | title |
标题,叠加层的简短说明。 | |
GMSMapView* | map |
此叠加层所在的地图。 | |
BOOL | 可点按 |
此叠加层是否应导致点按通知。 | |
整型 | Z-index |
较高的 zIndex 值叠加层将在较低的 zIndex 值图块层和叠加层之上绘制。 | |
ID | userData |
叠加层数据。 |
成员函数文档
+(实例类型)markerWithPosition: | (CLLocationCoordinate2D) | 职位 |
默认标记的便捷构造函数。
+ (UIImage *) markerImageWithColor: | (可为 null 的 UIColor *) | 颜色 |
创建默认标记图片的着色版本,以用作图标。
属性说明
- (CLLocationCoordinate2D) 位置 [read, write, assign] |
标记位置。
动画。
- (NSString*) 代码段 [read, write, copy] |
摘要文字,选择后会显示在信息窗口的标题下方。
- (UIImage*) 图标 [read, write, assign] |
要渲染的标记图标。
如果为 nil,则使用默认的 SDK 地点标记。
支持动画图片,但每个帧的大小必须相同或未定义。
支持使用 alignRectInsets 指定缩小的点按区域。这也重新定义了锚点的指定方式。对于动画图片,系统会使用动画的值,而不是单个帧。
- (UIView*) iconView [read, write, assign] |
要呈现的标记视图。
如果为 nil,则回退到 icon
属性。
支持为 UIView 的所有可添加动画效果的属性设置动画(frame
和 center
除外)。不支持更改这些属性或其相应的 CALayer 版本(包括 position
)。
请注意,无论其实际值如何,该视图都会将 clipsToBounds
设置为 YES。
- (BOOL) tracksViewChanges [read, write, assign] |
控制是否应在每帧上重新绘制此标记的图标。
请注意,当此图标从 NO 更改为 YES 时,一定会在下一个帧中重新绘制该图标。
默认值为 YES。如果 iconView
为 nil,则没有影响。
- (BOOL) tracksInfoWindowChanges [read, write, assign] |
控制是否应在每帧上重新绘制此标记的信息窗口。
请注意,当此控件从 NO 更改为 YES 时,系统一定会在下一个帧中重新绘制信息窗口。
默认值为 NO。
- (CGPoint) groundAnchor [read, write, assign] |
地面锚点用于指定图标图像中的点,该点锚定到地球表面的标记位置。
此点在连续空间 [0.0, 1.0] x [0.0, 1.0] 内指定,其中 (0,0) 是图片的左上角,(1,1) 是右下角。
如果图片有非零的 AlignmentRectInsets,则上面提到的左上角和右下角指的是图片的插入部分。
- (CGPoint) infoWindowAnchor [read, write, assign] |
信息窗口锚点指定图标图片中用来锚定信息窗口的点,该点将直接显示在这个点的上方。
此点在与 GroundAnchor 相同的空间内指定。
- (GMSMarkerAnimation)performAnimation [read, write, assign] |
控制将此标记放在GMSMapView时使用的动画(默认为 kGMSMarkerAnimationNone,无动画)。
- (BOOL) 可拖动 [read, write, assign] |
控制是否可以以可交互方式拖动此标记(默认为“否”)。
-(BOOL)平面 [read, write, assign] |
控制该标记是应平贴地球表面 (YES) 还是朝向镜头的广告牌(否、默认)。
- (CLLocationDegrees) 旋转 [read, write, assign] |
设置标记围绕标记锚点的顺时针角度(以度为单位)。
旋转的轴与标记垂直。旋转 0 对应于标记的默认位置。动画。
当地图上的标记为 Flat 标记时,默认位置为上北下南,且旋转方向可使标记始终在地图上保持平坦。当标记是广告牌时,默认位置为朝上,而且旋转时标记始终朝向镜头。
-(浮点)不透明度 [read, write, assign] |
设置标记的不透明度,介于 0(完全透明)和 1(默认)(含)之间。
- (GMSMarkerLayer*) 层 [read, assign] |
为此 GMSMarker 提供核心动画层。
- (GMSPanoramaView*) panoramaView [read, write, assign] |
panoramaView
,用于指定尝试显示此标记的全景视图。
请注意,如果标记的 position
离 panoramaView
的当前全景位置太远,则不会显示该标记,因为它太小。
可以设置为 nil,以便将该标记从其附加到的任何当前全景视图上删除。
一个标记可以同时在全景和地图上显示。
- (NSString*) 标题 [read, write, copy, inherited] |
标题,叠加层的简短说明。
某些叠加层(如标记)将在地图上显示标题。标题也是默认的无障碍文本。
- (GMSMapView*) 地图 [read, write, assign, inherited] |
此叠加层所在的地图。
设置此属性会将叠加层添加到地图中。如果将其设置为 nil,则会从地图中移除此叠加层。在任意给定时间,一个叠加层最多可在一份地图上激活。
- (BOOL) 可点按 [read, write, assign, inherited] |
此叠加层是否应导致点按通知。
某些叠加层(例如标记)默认可供点按。
-(整数)zIndex [read, write, assign, inherited] |
较高的 zIndex
值叠加层将在较低的 zIndex
值图块层和叠加层之上绘制。
相同的值会导致未定义的绘制顺序。标记除外:无论 zIndex
如何,标记始终会绘制在图块层和其他非标记叠加层之上;与其他叠加层相比,它们实际上被视为位于单独的 Z-index 组中。
- (id) userData [read, write, assign, inherited] |
叠加层数据。
您可以使用此属性将任意对象与此叠加层相关联。Google Maps SDK for iOS 既不会读取,也不会写入此属性。
请注意,userData 不应保留对任何 Maps 对象的强引用,否则可能会形成保留循环(以防止对象被释放)。