标记

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。
选择平台Android iOS JavaScript

标记指示地图上的单个位置。

默认情况下,标记使用与 Google 地图外观和风格一致的标准图标。若要自定义标记,您可以更改默认标记的颜色、使用自定义图标替换标记图片,或更改标记的其他属性。

为响应标记上的点击事件,您可以打开信息窗口。信息窗口在标记上方的弹出式窗口中显示文本或图片。您可以使用默认信息窗口显示文本,也可以创建自己的自定义信息窗口来完全控制其内容。

添加标记

如需添加标记,请创建一个包含 positiontitleGMSMarker 对象,并设置其 map

以下示例演示了如何将标记添加到现有 GMSMapView 对象。标记在 10,10 坐标处创建,当用户点击时,它会在信息窗口中显示字符串“Hello world”。

Swift

let position = CLLocationCoordinate2D(latitude: 10, longitude: 10)
let marker = GMSMarker(position: position)
marker.title = "Hello World"
marker.map = mapView
      

Objective-C

CLLocationCoordinate2D position = CLLocationCoordinate2DMake(10, 10);
GMSMarker *marker = [GMSMarker markerWithPosition:position];
marker.title = @"Hello World";
marker.map = mapView;
      

通过向地图添加 marker.appearAnimation 属性,您可以动画呈现向地图添加新标记的操作:

  • kGMSMarkerAnimationPop,可使标记在添加后从其 groundAnchor 弹出。
  • kGMSMarkerAnimationFadeIn,可使标记在添加时淡入。

移除标记

通过将 GMSMarkermap 属性设置为 nil,您可以从地图中移除标记。或者,您也可以通过调用 GMSMapView clear 方法移除当前在地图上的所有叠加层(包括标记)。

Swift

let camera = GMSCameraPosition.camera(
  withLatitude: -33.8683,
  longitude: 151.2086,
  zoom: 6
)
let mapView = GMSMapView.map(withFrame: .zero, camera: camera)
// ...
mapView.clear()
      

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
// ...
[mapView clear];
      

如果您在向地图添加标记后想对地图进行修改,请务必保留 GMSMarker 对象。您稍后可以通过更改此对象来修改该标记。

Swift

let position = CLLocationCoordinate2D(latitude: 10, longitude: 10)
let marker = GMSMarker(position: position)
marker.map = mapView
// ...
marker.map = nil
      

Objective-C

CLLocationCoordinate2D position = CLLocationCoordinate2DMake(10, 10);
GMSMarker *marker = [GMSMarker markerWithPosition:position];
marker.map = mapView;
// ...
marker.map = nil;
      

更改标记颜色

您可以自定义默认标记图片的颜色,方法是使用 markerImageWithColor: 请求默认图标的着色版本,并将生成的图片传递给 GMSMarker 的图标属性。

Swift

marker.icon = GMSMarker.markerImage(with: .black)
      

Objective-C

marker.icon = [GMSMarker markerImageWithColor:[UIColor blackColor]];
      

自定义标记图像

如果您想更改默认标记图片,您可以使用相应标记的 iconiconView 属性来设置自定义图标。

如果已设置 iconView,则 API 会忽略 icon 属性。只要设置了 iconView,就无法识别当前 icon 的更新。

使用标记的 `icon` 属性

以下代码段会在 icon 属性中创建带有自定义图标(作为 UIImage 提供)的标记。该图标的中心位于英国伦敦。该代码段假定您的应用包含一个名为“house.png”的图片。

Swift

let positionLondon = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127)
let london = GMSMarker(position: positionLondon)
london.title = "London"
london.icon = UIImage(named: "house")
london.map = mapView
      

Objective-C

CLLocationCoordinate2D positionLondon = CLLocationCoordinate2DMake(51.5, -0.127);
GMSMarker *london = [GMSMarker markerWithPosition:positionLondon];
london.title = @"London";
london.icon = [UIImage imageNamed:@"house"];
london.map = mapView;
      

如果您使用同一图片创建多个标记,请对每个标记使用相同的 UIImage 实例。这有助于提高显示多个标记时应用的性能。

此图片可能包含多个画面。此外,建议使用 alignmentRectInsets 属性,此属性适用于标记具有阴影或其他不可用区域的情况。

使用标记的 `iconView` 属性

下面这段代码通过设置标记的 iconView 属性创建了一个带有自定义图标的标记,并为标记的颜色变化添加了动画效果。该代码段假定您的应用包含一张名为“house.png”的图片。

Swift

import CoreLocation
import GoogleMaps

class MarkerViewController: UIViewController, GMSMapViewDelegate {
  var mapView: GMSMapView!
  var london: GMSMarker?
  var londonView: UIImageView?

  override func viewDidLoad() {
    super.viewDidLoad()

    let camera = GMSCameraPosition.camera(
      withLatitude: 51.5,
      longitude: -0.127,
      zoom: 14
    )
    let mapView = GMSMapView.map(withFrame: .zero, camera: camera)
    view = mapView

    mapView.delegate = self

    let house = UIImage(named: "House")!.withRenderingMode(.alwaysTemplate)
    let markerView = UIImageView(image: house)
    markerView.tintColor = .red
    londonView = markerView

    let position = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127)
    let marker = GMSMarker(position: position)
    marker.title = "London"
    marker.iconView = markerView
    marker.tracksViewChanges = true
    marker.map = mapView
    london = marker
  }

  func mapView(_ mapView: GMSMapView, idleAt position: GMSCameraPosition) {
    UIView.animate(withDuration: 5.0, animations: { () -> Void in
      self.londonView?.tintColor = .blue
    }, completion: {(finished) in
      // Stop tracking view changes to allow CPU to idle.
      self.london?.tracksViewChanges = false
    })
  }
}
      

Objective-C

@import CoreLocation;
@import GoogleMaps;

@interface MarkerViewController : UIViewController <GMSMapViewDelegate>
@property (strong, nonatomic) GMSMapView *mapView;
@end

@implementation MarkerViewController {
  GMSMarker *_london;
  UIImageView *_londonView;
}

- (void)viewDidLoad {
  [super viewDidLoad];

  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:51.5
                                                          longitude:-0.127
                                                               zoom:14];
  _mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  self.view = _mapView;

  _mapView.delegate = self;

  UIImage *house = [UIImage imageNamed:@"House"];
  house = [house imageWithRenderingMode:UIImageRenderingModeAlwaysTemplate];
  _londonView = [[UIImageView alloc] initWithImage:house];
  _londonView.tintColor = [UIColor redColor];

  CLLocationCoordinate2D position = CLLocationCoordinate2DMake(51.5, -0.127);
  _london = [GMSMarker markerWithPosition:position];
  _london.title = @"London";
  _london.iconView = _londonView;
  _london.tracksViewChanges = YES;
  _london.map = self.mapView;
}

- (void)mapView:(GMSMapView *)mapView idleAtCameraPosition:(GMSCameraPosition *)position {
  [UIView animateWithDuration:5.0
                   animations:^{
    self->_londonView.tintColor = [UIColor blueColor];
  }
                   completion:^(BOOL finished) {
    // Stop tracking view changes to allow CPU to idle.
    self->_london.tracksViewChanges = NO;
  }];
}

@end
      

由于 iconView 接受 UIView,因此您可以使用标准界面控件层次结构来定义标记,其中每个视图都具有一组标准的动画功能。您可以包括更改标记大小、颜色和 Alpha 级别,以及应用任意转换。iconView 属性支持为 UIView 的所有可设置动画属性的属性添加动画效果,但 framecenter 除外。

使用 iconView 时,请注意以下几点:

  • tracksViewChanges 设置为 YES 时,UIView 可能会要求使用资源,从而导致电池用量增加。相比之下,单帧 UIImage 是静态的,不需要重新渲染。
  • 如果屏幕上有许多标记,并且每个标记都有自己的 UIView,并且所有标记都在同时跟踪更改,那么有些设备可能会难以渲染地图。
  • iconView 不会响应用户互动,因为它是视图的快照。
  • 无论 clipsToBounds 设为 YES 还是如此,该视图的行为都类似。您可以应用超出边界的转换,但绘制的对象必须位于对象的边界内。系统会监控和应用所有转换/偏移。简而言之:子视图必须包含在视图中。

为了决定何时设置 tracksViewChanges 属性,您应权衡性能注意事项与自动重新绘制标记的优势。例如:

  • 如果要进行一系列更改,您可以将属性更改为 YES,然后再改回 NO
  • 如果动画正在运行或正在异步加载内容,您应将该属性设置为 YES,直到操作完成。

更改标记的不透明度

您可以通过标记的 opacity 属性来控制其不透明度。您应将不透明度指定为介于 0.0 和 1.0 之间的浮点值,其中 0 表示完全透明,1 表示完全不透明。

Swift

marker.opacity = 0.6
      

Objective-C

marker.opacity = 0.6;
      

您可以通过 GMSMarkerLayer 使用核心动画为标记的不透明度添加动画效果。

将标记平面化

标记图标通常根据设备的屏幕(而不是地图表面)的方向进行绘制,因此旋转、倾斜或缩放地图不一定会改变标记的朝向。

您可以将图标方向设置为平面的,与地球方向相对。Flat 标记会在地图旋转时旋转,并在地图倾斜时改变视角。与常规标记一样,当地图放大或缩小时,平面标记将保持大小不变。

如需更改标记的朝向,请将标记的 flat 属性设置为 YEStrue

Swift

let positionLondon = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127)
let londonMarker = GMSMarker(position: positionLondon)
londonMarker.isFlat = true
londonMarker.map = mapView
      

Objective-C

CLLocationCoordinate2D positionLondon = CLLocationCoordinate2DMake(51.5, -0.127);
GMSMarker *londonMarker = [GMSMarker markerWithPosition:positionLondon];
londonMarker.flat = YES;
londonMarker.map = mapView;
      

旋转标记

您可以通过设置 rotation 属性来旋转标记围绕其锚点。将旋转指定为 CLLocationDegrees 类型,以与默认位置所呈顺时针角度来表示。当地图上的标记为 Flat 标记时,默认位置为指向北方。

以下示例代码可将标记旋转 90°。将 groundAnchor 属性设置为 0.5,0.5 可使标记围绕其中心而不是底部旋转。

Swift

let degrees = 90.0
londonMarker.groundAnchor = CGPoint(x: 0.5, y: 0.5)
londonMarker.rotation = degrees
londonMarker.map = mapView
      

Objective-C

CLLocationDegrees degrees = 90;
londonMarker.groundAnchor = CGPointMake(0.5, 0.5);
londonMarker.rotation = degrees;
londonMarker.map = mapView;
      

处理标记上的事件

您可以监听地图上发生的事件,例如当用户点按某个标记时。如需监听事件,您必须实现 GMSMapViewDelegate 协议。请参阅事件指南以及 GMSMapViewDelegate 上的方法列表。如需了解街景事件,请参阅 GMSPanoramaViewDelegate