Sự kiện

Chọn nền tảng: Android iOS JavaScript

Khi sử dụng Maps SDK cho iOS, bạn có thể theo dõi các sự kiện xảy ra trên bản đồ, chẳng hạn như sự kiện thay đổi camera hoặc sự kiện nhấn vào điểm đánh dấu.

Giới thiệu

Để theo dõi các sự kiện, bạn phải triển khai giao thức GMSMapViewDelegate. Thông thường, bạn triển khai giao thức này trên bộ điều khiển chế độ xem hiển thị bản đồ. Dưới đây là một ví dụ:

Swift

import GoogleMaps

class Events: UIViewController, GMSMapViewDelegate {
  // ...
}

Objective-C

@import GoogleMaps;

@interface Events : UIViewController <GMSMapViewDelegate>

@end

Khi GMSMapView được tạo, bạn có thể đặt uỷ quyền của GMSMapView cho trình điều khiển chế độ xem. GMSMapViewDelegate chỉ cung cấp các phương thức không bắt buộc. Để theo dõi một sự kiện cụ thể, bạn phải triển khai phương thức có liên quan.

Swift

override func loadView() {
  super.loadView()
  let camera = GMSCameraPosition.camera(
    withLatitude: 1.285,
    longitude: 103.848,
    zoom: 12
  )
  let mapView = GMSMapView.map(withFrame: .zero, camera: camera)
  mapView.delegate = self
  self.view = mapView
}

// MARK: GMSMapViewDelegate

func mapView(_ mapView: GMSMapView, didTapAt coordinate: CLLocationCoordinate2D) {
  print("You tapped at \(coordinate.latitude), \(coordinate.longitude)")
}

Objective-C

- (void)loadView {
  [super loadView];
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:1.285
                                                          longitude:103.848
                                                               zoom:12];
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  mapView.delegate = self;
  self.view = mapView;
}

#pragma mark - GMSMapViewDelegate

- (void)mapView:(GMSMapView *)mapView didTapAtCoordinate:(CLLocationCoordinate2D)coordinate {
  NSLog(@"You tapped at %f,%f", coordinate.latitude, coordinate.longitude);
}

Vị trí camera

Khi sử dụng GMSMapViewDelegate, bạn có thể lắng nghe các thay đổi về vị trí camera dùng để kết xuất bản đồ. Có 3 sự kiện riêng biệt.

  • mapView:willMove: cho biết vị trí của camera sắp thay đổi. Nếu đối số gesture được đặt thành YES, thì điều này là do người dùng thực hiện một cử chỉ tự nhiên trên GMSMapView, chẳng hạn như thao tác xoay hoặc nghiêng. Nếu không, NO cho biết đây là một phần của thay đổi theo chương trình – ví dụ: thông qua các phương thức như animateToCameraPosition: hoặc cập nhật trực tiếp lớp của bản đồ. Điều này cũng có thể xảy ra NO nếu người dùng đã nhấn vào nút Vị trí của tôi hoặc nút la bàn. Các nút này tạo ra ảnh động làm thay đổi camera.

    Phương thức này có thể được gọi nhiều lần trước khi mapView:idleAtCameraPosition: được gọi, mặc dù điều này thường chỉ xảy ra nếu ảnh động và cử chỉ diễn ra cùng lúc – ví dụ: một cử chỉ sẽ huỷ mọi ảnh động hiện tại và gọi mapView:willMove: lần thứ hai.

  • mapView:didChangeCameraPosition: được gọi nhiều lần trong một cử chỉ hoặc ảnh động, luôn sau khi gọi mapView:willMove:. Hàm này nhận được vị trí máy ảnh trung gian.

  • Cuối cùng, mapView:idleAtCameraPosition: sẽ được gọi khi vị trí camera trên GMSMapView ở trạng thái rảnh và chỉ định vị trí camera có liên quan. Lúc này, tất cả ảnh động và cử chỉ đều đã dừng.

    Các ứng dụng có thể sử dụng sự kiện này để kích hoạt quá trình làm mới các điểm đánh dấu hoặc nội dung khác đang hiển thị trên GMSMapView, thay vì tải lại nội dung trên mọi thay đổi về camera, chẳng hạn.

Ví dụ: một ứng dụng có thể xoá GMSMapView khi di chuyển, sau đó mã hoá địa lý ngược vị trí mà camera dừng lại.

Swift

let geocoder = GMSGeocoder()

func mapView(_ mapView: GMSMapView, willMove gesture: Bool) {
  mapView.clear()
}

func mapView(_ mapView: GMSMapView, idleAt cameraPosition: GMSCameraPosition) {
    geocoder.reverseGeocodeCoordinate(cameraPosition.target) { (response, error) in
      guard error == nil else {
        return
      }

      if let result = response?.firstResult() {
        let marker = GMSMarker()
        marker.position = cameraPosition.target
        marker.title = result.lines?[0]
        marker.snippet = result.lines?[1]
        marker.map = mapView
      }
    }
  }

Objective-C

GMSGeocoder *geocoder;

- (void)mapView:(GMSMapView *)mapView willMove:(BOOL)gesture {
  [mapView clear];
}

- (void)mapView:(GMSMapView *)mapView idleAtCameraPosition:(GMSCameraPosition *)cameraPosition {
  id handler = ^(GMSReverseGeocodeResponse *response, NSError *error) {
    if (error != nil) {
      return;
    }
    GMSReverseGeocodeResult *result = response.firstResult;
    GMSMarker *marker = [GMSMarker markerWithPosition:cameraPosition.target];
    marker.title = result.lines[0];
    marker.snippet = result.lines[1];
    marker.map = mapView;
  };
  [geocoder reverseGeocodeCoordinate:cameraPosition.target completionHandler:handler];
}

Sự kiện tại các doanh nghiệp và địa điểm yêu thích khác

Theo mặc định, các địa điểm yêu thích (POI) sẽ xuất hiện trên bản đồ cơ sở cùng với các biểu tượng tương ứng. POI bao gồm công viên, trường học, toà nhà chính phủ và nhiều địa điểm khác, cũng như POI doanh nghiệp như cửa hàng, nhà hàng và khách sạn.

Bạn có thể phản hồi các sự kiện nhấp vào một địa điểm yêu thích. Xem hướng dẫn về doanh nghiệp và các địa điểm yêu thích khác.

Các sự kiện khác

Để tìm hiểu về danh sách đầy đủ các phương thức trên GMSMapViewDelegate, hãy xem hướng dẫn tham khảo.