इवेंट

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript

iOS के लिए Maps SDK टूल का इस्तेमाल करके, मैप पर होने वाले इवेंट सुने जा सकते हैं. जैसे, कैमरा बदलने के इवेंट या मार्कर टैप इवेंट.

शुरुआती जानकारी

इवेंट को सुनने के लिए, आपको 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 का इस्तेमाल करके, मैप को रेंडर करने के लिए इस्तेमाल की गई कैमरे की स्थिति में हुए बदलावों को सुना जा सकता है. ये तीन अलग-अलग इवेंट होते हैं.

• mapView:willMove: बताता है कि कैमरे की स्थिति बदलने वाली है. अगर gesture आर्ग्युमेंट को YES पर सेट किया गया है, तो इसकी वजह यह है कि उपयोगकर्ता ने GMSMapView पर सामान्य जेस्चर किया है, जैसे कि पैन या झुकाना. नहीं तो, NO बताता है कि यह प्रोग्राम के हिसाब से होने वाले बदलाव का हिस्सा है. उदाहरण के लिए, animateToCameraPosition: जैसे तरीकों से या सीधे मैप की लेयर को अपडेट करके. अगर उपयोगकर्ता ने मेरी जगह या कंपास बटन पर टैप किया है, तो यह NO भी हो सकता है. ये बटन, कैमरा बदलने वाले ऐनिमेशन जनरेट करते हैं.

  mapView:idleAtCameraPosition: के शुरू होने से पहले, इस तरीके को कई बार इस्तेमाल किया जा सकता है. हालांकि, ऐसा आम तौर पर तब होता है, जब ऐनिमेशन और हाथ के जेस्चर एक ही समय पर हों. जैसे, जेस्चर से मौजूदा ऐनिमेशन रद्द हो जाएगा और mapView:willMove: को दोबारा कॉल किया जाएगा.

• mapView:didChangeCameraPosition: को हाथ के जेस्चर (हाव-भाव) या ऐनिमेशन के दौरान बार-बार कॉल किया जाता है. mapView:willMove: पर कॉल करने के बाद, हमेशा कॉल किया जाता है. इसे कैमरे की इंटरमीडिएट पोज़िशन से पास किया जाता है.

• आखिर में, जब GMSMapView पर कैमरा कुछ समय से इस्तेमाल में न हो, तब mapView:idleAtCameraPosition: को शुरू किया जाता है और कैमरे की सही पोज़िशन तय की जाती है. इस समय, सभी ऐनिमेशन और हाथ के जेस्चर रुक गए हैं.

  ऐप्लिकेशन इस इवेंट का इस्तेमाल, 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 पर तरीकों की पूरी सूची के बारे में जानने के लिए, रेफ़रंस गाइड देखें.