กิจกรรม

คุณสามารถฟังเหตุการณ์ที่เกิดขึ้นบนแผนที่ เช่น เหตุการณ์การเปลี่ยนแปลงของกล้องหรือเหตุการณ์การแตะเพื่อทําเครื่องหมายได้โดยใช้ Maps SDK สําหรับ iOS

บทนำ

หากต้องการฟังเหตุการณ์ คุณต้องใช้โปรโตคอล GMSMapViewDelegate โดยปกติคุณจะใช้โปรโตคอลนี้ในตัวควบคุมการแสดงผลที่แสดงแผนที่ ตัวอย่างมีดังนี้

import GoogleMaps

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

@import GoogleMaps;

@interface Events : UIViewController <GMSMapViewDelegate>

@end
      

เมื่อสร้าง GMSMapView แล้ว คุณสามารถตั้งค่าการมอบสิทธิ์ให้กับเครื่องมือควบคุมข้อมูลพร็อพเพอร์ตี้ได้ GMSMapViewDelegate มีเฉพาะวิธีการที่ไม่บังคับเท่านั้น หากต้องการฟังเหตุการณ์ใดเหตุการณ์หนึ่ง คุณต้องใช้เมธอดที่เกี่ยวข้อง

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)")
}
      

- (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);
}
      

ตําแหน่งของกล้อง

เมื่อใช้ GMSMapViewDelegate คุณจะฟังการเปลี่ยนแปลงตําแหน่งของกล้องที่ใช้แสดงผลแผนที่ได้ โดยมี 3 เหตุการณ์ที่แตกต่างกัน

• mapView:willMove: บ่งบอกว่าตําแหน่งของกล้องกําลังจะมีการเปลี่ยนแปลง หากตั้งค่าอาร์กิวเมนต์ gesture เป็น YES นั่นเป็นเพราะผู้ใช้ทําท่าทางสัมผัสตามธรรมชาติใน GMSMapView เช่น เลื่อนหรือเอียง ไม่เช่นนั้น NO จะบ่งบอกว่าการเปลี่ยนแปลงนี้เป็นส่วนหนึ่งของการเปลี่ยนแปลงแบบเป็นโปรแกรม เช่น ผ่านเมธอดต่างๆ เช่น animateToCameraPosition: หรืออัปเดตเลเยอร์ของแผนที่โดยตรง หรืออาจเป็น NO หากผู้ใช้แตะปุ่ม "ตําแหน่งของฉัน" หรือ "เข็มทิศ" ซึ่งจะสร้างภาพเคลื่อนไหวที่เปลี่ยนกล้อง

  วิธีนี้อาจเรียกใช้หลายครั้งก่อนที่ mapView:idleAtCameraPosition: จะเรียกใช้ แต่มักจะเกิดขึ้นก็ต่อเมื่อภาพเคลื่อนไหวและท่าทางสัมผัสเกิดขึ้นพร้อมกัน ท่าทางสัมผัสจะยกเลิกภาพเคลื่อนไหวปัจจุบัน เช่น จะเรียก mapView:willMove: เป็นครั้งที่ 2

• ระบบจะเรียก mapView:didChangeCameraPosition: ซ้ําๆ ระหว่างท่าทางสัมผัสหรือภาพเคลื่อนไหว หลังการโทรไปยัง mapView:willMove: เสมอ แต่ส่งผ่านตําแหน่งกล้องตรงกลาง

• สุดท้าย ระบบจะเรียกใช้ mapView:idleAtCameraPosition: เมื่อตําแหน่งกล้องใน GMSMapView ไม่มีการใช้งาน และระบุตําแหน่งกล้องที่เกี่ยวข้อง ณ จุดนี้ ภาพเคลื่อนไหวและท่าทางสัมผัสทั้งหมดหยุดทํางานแล้ว

  แอปพลิเคชันสามารถใช้เหตุการณ์นี้เพื่อทริกเกอร์การรีเฟรชของเครื่องหมายหรือเนื้อหาอื่นๆ ที่แสดงอยู่บน GMSMapView เช่น การโหลดเนื้อหาซ้ําในการเปลี่ยนแปลงกล้องทุกครั้ง

เช่น แอปพลิเคชันจะล้าง GMSMapView ขณะย้ายได้ จากนั้นกลับพิกัดของตําแหน่งที่กล้องจะพัก

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
      }
    }
  }
      

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];
}
      

กิจกรรมเกี่ยวกับธุรกิจและจุดสนใจอื่นๆ

โดยค่าเริ่มต้น จุดสนใจ (POI) จะปรากฏในแผนที่พื้นฐานพร้อมกับไอคอนที่เกี่ยวข้อง จุดที่น่าสนใจ ได้แก่ สวนสาธารณะ โรงเรียน อาคารหน่วยงานราชการ และอื่นๆ รวมถึงจุดที่น่าสนใจสําหรับธุรกิจ เช่น ร้านค้า ร้านอาหาร และโรงแรม

คุณตอบกลับกิจกรรมการคลิกในจุดที่น่าสนใจได้ ดูคําแนะนําเกี่ยวกับธุรกิจและจุดสนใจอื่นๆ

เหตุการณ์อื่นๆ

หากต้องการดูรายการเมธอดทั้งหมดใน GMSMapViewDelegate โปรดดูคู่มืออ้างอิง