概览
GMSGroundOverlay - 用于指定存在于地球表面上的地面叠加层的可用选项。
与标记不同,地面叠加层的位置需明确指定,不会面向镜头。
继承 GMSOverlay。
静态公开成员函数 | |
(实例类型) | + groundOverlayWithBounds:icon: |
GMSGroundOverlay的特定bounds 和icon 的便捷构造函数。 | |
(实例类型) | + groundOverlayWithPosition:icon:zoomLevel: |
用于构造在position 处呈现指定icon 的GMSGroundOverlay,就像图片的实际尺寸与zoomLevel 处的相机像素一样。 | |
属性 | |
CLLocationCoordinate2D | position |
该GMSGroundOverlay的位置,或者更具体地说,就是其锚点的实际位置。 | |
CGPoint | 锚标记 |
锚点用于指定该GMSGroundOverlay相对于bounds 在地球上的锚定位置。 | |
界面图片 * | 图标 |
用于在 Google 地球的 bounds 内渲染的图标。 | |
float | 不透明度 |
设置地面叠加层的不透明度,介于 0(完全透明)和 1(默认)之间(包括 0 和 1)。 | |
CLLocationDirection | 方位 |
此地面叠加层的方向角,以度为单位。 | |
GMSCoordinateBounds * | 边界 |
地球上绘制 icon 的 2D 边界。 | |
NSString * | title |
标题,叠加层的简短说明。 | |
GMSMapView * | map |
此叠加层所在的地图。 | |
BOOL | 可点按 |
此叠加层是否应引起点按通知。 | |
int | zIndex |
zIndex 值较高的叠加层将在 zIndex 值较低的图块层和叠加层之上绘制。 | |
id | userData |
叠加层数据。 |
成员函数文档
+ (instancetype) groundOverlayWithBounds: | (可为 null 的 GMSCoordinateBounds *) | 边界 | |
图标: | (nullable UIImage *) | 图标 | |
GMSGroundOverlay的特定bounds
和icon
的便捷构造函数。
将相应地设置 position
。
+ (instancetype) groundOverlayWithPosition: | (CLLocationCoordinate2D) | position | |
图标: | (nullable UIImage *) | 图标 | |
zoomLevel: | (CGFloat) | zoomLevel | |
用于构造在position
处呈现指定icon
的GMSGroundOverlay,就像图片的实际尺寸与zoomLevel
处的相机像素一样。
属性说明
- (CLLocationCoordinate2D) position [read, write, assign] |
该GMSGroundOverlay的位置,或者更具体地说,就是其锚点的实际位置。
如果更改此位置,bounds
将围绕新位置移动。
- (CGPoint) anchor [read, write, assign] |
锚点用于指定该GMSGroundOverlay相对于bounds
在地球上的锚定位置。
如果进行修改,position
将被设置为 bounds
内的相应新位置。
- (UIImage*) 图标 [read, write, assign] |
用于在 Google 地球的 bounds
内渲染的图标。
如果此属性为 nil,则将不会显示叠加层(这与具有默认图片的GMSMarker不同)。
-(浮点数)不透明度 [read, write, assign] |
设置地面叠加层的不透明度,介于 0(完全透明)和 1(默认)之间(包括 0 和 1)。
- (CLLocationDirection) 方位 [read, write, assign] |
此地面叠加层的方向角,以度为单位。
默认值 0 表示此地面叠加层沿着地球常规 Y 轴向上/向下指向。
- (GMSCoordinateBounds*)边界 [read, write, assign] |
地球上绘制 icon
的 2D 边界。
更改此值会相应地调整position
。
- (NSString*) title [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 对象的任何强引用,否则可能会形成保留循环(阻止对象释放)。