เมื่อใช้ 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 ประกอบด้วยสวนสาธารณะ โรงเรียน อาคารราชการ และอื่นๆ รวมถึงจุดธุรกิจที่น่าสนใจ เช่น ร้านค้า ร้านอาหาร และโรงแรม
คุณสามารถตอบสนองต่อกิจกรรมการคลิกบนจุดที่น่าสนใจได้ ดูคำแนะนำเกี่ยวกับธุรกิจและจุดที่น่าสนใจอื่นๆ
เหตุการณ์อื่นๆ
ดูรายการเมธอดทั้งหมดใน GMSMapViewDelegate ได้ที่คู่มืออ้างอิง