เมื่อใช้ 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 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); }
ตําแหน่งกล้อง
เมื่อใช้ 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
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
โปรดดูคู่มืออ้างอิง