Điểm đánh dấu

Điểm đánh dấu cho biết các vị trí riêng lẻ trên bản đồ.

Theo mặc định, điểm đánh dấu sử dụng biểu tượng chuẩn có giao diện phổ biến của Google Maps. Nếu muốn tuỳ chỉnh điểm đánh dấu, bạn có thể thay đổi màu của điểm đánh dấu mặc định hoặc thay thế hình ảnh điểm đánh dấu bằng một biểu tượng tuỳ chỉnh hoặc thay đổi các thuộc tính khác của điểm đánh dấu.

Để phản hồi sự kiện nhấp chuột vào điểm đánh dấu, bạn có thể mở một cửa sổ thông tin. Cửa sổ thông tin hiển thị văn bản hoặc hình ảnh trong cửa sổ hộp thoại phía trên điểm đánh dấu. Bạn có thể sử dụng cửa sổ thông tin mặc định để hiển thị văn bản hoặc tạo cửa sổ thông tin tuỳ chỉnh của riêng mình để kiểm soát hoàn toàn nội dung của cửa sổ đó.

Thêm điểm đánh dấu

Để thêm điểm đánh dấu, hãy tạo một đối tượng GMSMarker bao gồm position và title, rồi đặt map của đối tượng đó.

Ví dụ sau đây minh hoạ cách thêm điểm đánh dấu vào một đối tượng GMSMapView hiện có. Điểm đánh dấu được tạo tại toạ độ 10,10 và hiển thị chuỗi "Hello world" trong cửa sổ thông tin khi người dùng nhấp vào.

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

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

Bạn có thể tạo ảnh động cho việc thêm điểm đánh dấu mới vào bản đồ bằng cách đặt thuộc tính marker.appearAnimation thành:

• kGMSMarkerAnimationPop để làm cho điểm đánh dấu bật lên từ groundAnchor khi được thêm vào.
• kGMSMarkerAnimationFadeIn để làm cho điểm đánh dấu mờ dần khi được thêm vào.

Xoá điểm đánh dấu

Bạn có thể xoá điểm đánh dấu khỏi bản đồ bằng cách đặt thuộc tính map của GMSMarker thành nil. Ngoài ra, bạn có thể xoá tất cả lớp phủ (bao gồm cả điểm đánh dấu) hiện có trên bản đồ bằng cách gọi phương thức GMSMapView clear.

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

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = camera;
mapView = [[GMSMapView alloc] initWithOptions:options];
// ...
[mapView clear];
      

Nếu bạn muốn sửa đổi điểm đánh dấu sau khi thêm điểm đánh dấu đó vào bản đồ, hãy nhớ giữ lại đối tượng GMSMarker. Bạn có thể sửa đổi điểm đánh dấu sau này bằng cách thay đổi đối tượng này.

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

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

Thay đổi màu của điểm đánh dấu

Bạn có thể tuỳ chỉnh màu của hình ảnh điểm đánh dấu mặc định bằng cách yêu cầu phiên bản có màu của biểu tượng mặc định bằng markerImageWithColor: và truyền hình ảnh thu được vào thuộc tính biểu tượng của GMSMarker.

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

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

Tuỳ chỉnh hình ảnh điểm đánh dấu

Nếu muốn thay đổi hình ảnh điểm đánh dấu mặc định, bạn có thể đặt biểu tượng tuỳ chỉnh bằng cách sử dụng thuộc tính icon hoặc iconView của điểm đánh dấu. Nếu bạn đặt iconView, API sẽ bỏ qua thuộc tính icon.

Sử dụng thuộc tính icon của điểm đánh dấu

Đoạn mã sau đây tạo một điểm đánh dấu có biểu tượng tuỳ chỉnh được cung cấp dưới dạng UIImage trong thuộc tính icon. Biểu tượng này nằm ở trung tâm London, Anh. Đoạn mã giả định rằng ứng dụng của bạn chứa một hình ảnh có tên là "house.png".

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
      

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

Nếu bạn đang tạo nhiều điểm đánh dấu có cùng một hình ảnh, hãy sử dụng cùng một thực thể của UIImage cho mỗi điểm đánh dấu. Điều này giúp cải thiện hiệu suất của ứng dụng và tối ưu hoá việc sử dụng bộ nhớ đệm hoạ tiết khi hiển thị nhiều điểm đánh dấu.

Hình ảnh này có thể có nhiều khung hình. Ngoài ra, thuộc tính alignmentRectInsets cũng được tuân thủ, điều này rất hữu ích nếu điểm đánh dấu có bóng hoặc vùng không sử dụng được khác.

Sử dụng thuộc tính iconView của điểm đánh dấu

Đoạn mã sau đây tạo một điểm đánh dấu có biểu tượng tuỳ chỉnh bằng cách đặt thuộc tính iconView của điểm đánh dấu và tạo ảnh động cho sự thay đổi về màu sắc của điểm đánh dấu. Đoạn mã giả định rằng ứng dụng của bạn chứa một hình ảnh có tên là "house.png".

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 options = GMSMapViewOptions()
    options.camera = camera
    let mapView = GMSMapView(options: options)
    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
    })
  }
}
      

@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];
  GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
  options.camera = camera;
  _mapView = [[GMSMapView alloc] initWithOptions:options];
  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
      

Vì iconView chấp nhận UIView, nên bạn có thể có một hệ phân cấp các thành phần điều khiển trên giao diện người dùng chuẩn xác định điểm đánh dấu, mỗi thành phần hiển thị có một bộ tiêu chuẩn các khả năng ảnh động. Bạn có thể thay đổi kích thước, màu sắc và mức độ alpha của điểm đánh dấu, cũng như áp dụng các phép biến đổi tuỳ ý. Thuộc tính iconView hỗ trợ ảnh động cho tất cả các thuộc tính có thể tạo ảnh động của UIView, ngoại trừ frame và center.

Xin lưu ý những điểm sau khi sử dụng iconView:

• UIView có thể tiêu tốn nhiều tài nguyên khi tracksViewChanges được đặt thành YES, điều này có thể làm tăng mức sử dụng pin. Trong khi đó, một khung hình UIImage là tĩnh và không cần kết xuất lại.
• Một số thiết bị có thể gặp khó khăn khi kết xuất bản đồ nếu bạn có nhiều điểm đánh dấu trên màn hình và mỗi điểm đánh dấu có UIView riêng, đồng thời tất cả điểm đánh dấu đều theo dõi các thay đổi cùng một lúc.
• iconView không phản hồi hoạt động tương tác của người dùng vì đây là ảnh chụp nhanh của khung hiển thị.
• Chế độ xem hoạt động như thể clipsToBounds được đặt thành YES, bất kể giá trị thực tế của chế độ xem đó. Bạn có thể áp dụng các phép biến đổi hoạt động bên ngoài giới hạn, nhưng đối tượng bạn vẽ phải nằm trong giới hạn của đối tượng. Tất cả các phép biến đổi/dịch chuyển đều được theo dõi và áp dụng. Nói ngắn gọn: các thành phần hiển thị phụ phải nằm trong thành phần hiển thị.
• Để sử dụng -copyWithZone: trên GMSMarker, trước tiên, bạn phải sao chép GMSMarker, sau đó đặt một thực thể mới của iconView trên bản sao. UIView không hỗ trợ NSCopying nên không thể sao chép iconView.

Để quyết định thời điểm đặt thuộc tính tracksViewChanges, bạn nên cân nhắc các yếu tố về hiệu suất so với lợi ích của việc tự động vẽ lại điểm đánh dấu. Ví dụ:

• Nếu có một loạt thay đổi cần thực hiện, bạn có thể thay đổi thuộc tính thành YES rồi quay lại NO.
• Khi ảnh động đang chạy hoặc nội dung đang được tải không đồng bộ, bạn nên giữ nguyên thuộc tính được đặt thành YES cho đến khi các thao tác hoàn tất.

Thay đổi độ mờ của điểm đánh dấu

Bạn có thể kiểm soát độ mờ của điểm đánh dấu bằng thuộc tính opacity. Bạn nên chỉ định độ mờ dưới dạng số thực từ 0 đến 1, trong đó 0 là hoàn toàn trong suốt và 1 là hoàn toàn mờ.

marker.opacity = 0.6
      

marker.opacity = 0.6;
      

Bạn có thể tạo ảnh động cho độ mờ của điểm đánh dấu bằng Core Animation bằng cách sử dụng GMSMarkerLayer.

Làm phẳng điểm đánh dấu

Biểu tượng điểm đánh dấu thường được vẽ theo hướng màn hình của thiết bị thay vì bề mặt của bản đồ, vì vậy, việc xoay, nghiêng hoặc thu phóng bản đồ không nhất thiết thay đổi hướng của điểm đánh dấu.

Bạn có thể đặt hướng của điểm đánh dấu phẳng so với trái đất. Điểm đánh dấu phẳng sẽ xoay khi bản đồ xoay và thay đổi phối cảnh khi bản đồ nghiêng. Giống như điểm đánh dấu thông thường, điểm đánh dấu phẳng vẫn giữ nguyên kích thước khi bản đồ được phóng to hoặc thu nhỏ.

Để thay đổi hướng của điểm đánh dấu, hãy đặt thuộc tính flat của điểm đánh dấu thành YES hoặc true.

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

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

Xoay điểm đánh dấu

Bạn có thể xoay điểm đánh dấu xung quanh điểm neo bằng cách đặt thuộc tính rotation. Chỉ định chế độ xoay dưới dạng loại CLLocationDegrees, được đo bằng độ theo chiều kim đồng hồ từ vị trí mặc định. Khi điểm đánh dấu nằm phẳng trên bản đồ, vị trí mặc định là hướng Bắc.

Ví dụ sau đây xoay điểm đánh dấu 90°. Việc đặt thuộc tính groundAnchor thành 0.5,0.5 sẽ khiến điểm đánh dấu xoay quanh tâm thay vì xoay quanh chân điểm đánh dấu.

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

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

Xử lý sự kiện trên điểm đánh dấu

Bạn có thể theo dõi các sự kiện xảy ra trên bản đồ, chẳng hạn như khi người dùng nhấn vào một điểm đánh dấu. Để nghe sự kiện, bạn phải triển khai giao thức GMSMapViewDelegate. Hãy xem phần sự kiện và cử chỉ của điểm đánh dấu để tìm hiểu cách xử lý các sự kiện cụ thể của điểm đánh dấu. Hướng dẫn về sự kiện cũng cung cấp danh sách các phương thức trên GMSMapViewDelegate. Đối với các sự kiện trong Chế độ xem đường phố, hãy xem GMSPanoramaViewDelegate.