GMSMarker 类参考文档

GMSMarker 类参考文档

概览

标记是放置在地图表面的特定点的图标。

标记的图标是相对于设备的屏幕(而非地图表面)绘制的;也就是说,标记不会随着地图旋转、倾斜或缩放而改变方向。

继承 GMSOverlay

静态公共成员函数

(实例类型)+ markerWithPosition:
 默认标记的便捷构造函数。
(UI 图片 *)+ markerImageWithColor:
 创建默认标记图片的着色版本,以用作图标。

属性

CLLocationCoordinate2D职位
 标记位置。
NSString * 代码段
 摘要文字,选择后会显示在信息窗口的标题下方。
UIImage * 图标
 要渲染的标记图标。
UIView * iconView
 要呈现的标记视图。
BOOL tracksViewChanges
 控制是否应在每帧上重新绘制此标记的图标。
BOOL tracksInfoWindowChanges
 控制是否应在每帧上重新绘制此标记的信息窗口。
CGPointGroundAnchor
 地面锚点用于指定图标图像中的点,该点锚定到地球表面的标记位置。
CGPointinfoWindowAnchor
 信息窗口锚点指定图标图片中用来锚定信息窗口的点,该点将直接显示在这个点的上方。
GMSMarkerAnimation显示动画
 控制将此标记放在GMSMapView时使用的动画(默认为 kGMSMarkerAnimationNone,无动画)。
BOOL 可拖动
 控制是否可以以可交互方式拖动此标记(默认为“否”)。
BOOL 平面
 控制该标记是应平贴地球表面 (YES) 还是朝向镜头的广告牌(否、默认)。
CLLocationDegrees旋转
 设置标记围绕标记锚点的顺时针角度(以度为单位)。
浮点数不透明度
 设置标记的不透明度,介于 0(完全透明)和 1(默认)(含)之间。
GMSMarkerLayer*图层
 为此 GMSMarker 提供核心动画层。
GMSPanoramaView*PanoramaramaView
 panoramaView,用于指定尝试显示此标记的全景视图。
NSString * title
 标题,叠加层的简短说明。
GMSMapView*map
 此叠加层所在的地图。
BOOL 可点按
 此叠加层是否应导致点按通知。
整型Z-index
 较高的 zIndex 值叠加层将在较低的 zIndex 值图块层和叠加层之上绘制。
IDuserData
 叠加层数据。

成员函数文档

+(实例类型)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 的所有可添加动画效果的属性设置动画(framecenter 除外)。不支持更改这些属性或其相应的 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,用于指定尝试显示此标记的全景视图。

请注意,如果标记的 positionpanoramaView 的当前全景位置太远,则不会显示该标记,因为它太小。

可以设置为 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 对象的强引用,否则可能会形成保留循环(以防止对象被释放)。