กิจกรรม

เลือกแพลตฟอร์ม: Android iOS JavaScript

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

บทนำ

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

Swift

import GoogleMaps

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

Objective-C

@import GoogleMaps;

@interface Events : UIViewController <GMSMapViewDelegate>

@end
      

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

Swift

override func loadView() {
  super.loadView()
  let camera = GMSCameraPosition.camera(
    withLatitude: 1.285,
    longitude: 103.848,
    zoom: 12
  )
  let options = GMSMapViewOptions()
  options.camera = camera
  let mapView = GMSMapView(options: options)
  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];
  GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
  options.camera = camera;
  GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
  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 เมื่อเคลื่อนที่ แล้ว แปลงรหัสพิกัดภูมิศาสตร์แบบย้อนกลับสำหรับตำแหน่งที่กล้องหยุด

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

static 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) จะปรากฏบนแผนที่ฐานพร้อมกับไอคอนที่เกี่ยวข้อง POI ประกอบด้วยสวนสาธารณะ โรงเรียน อาคารราชการ และอื่นๆ รวมถึง POI ของธุรกิจ เช่น ร้านค้า ร้านอาหาร และโรงแรม

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

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

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