इवेंट

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

  • 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

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

कारोबारों और अन्य लोकप्रिय जगहों पर होने वाले इवेंट

डिफ़ॉल्ट रूप से, लोकप्रिय जगहें (पीओआई) बुनियादी मैप पर उनके आइकॉन के साथ दिखती हैं. लोकप्रिय जगहों में पार्क, स्कूल, सरकारी इमारतें वगैरह शामिल हैं. साथ ही, कारोबार की लोकप्रिय जगहें भी शामिल हैं, जैसे कि दुकानें, रेस्टोरेंट, और होटल.

किसी लोकप्रिय जगह पर क्लिक इवेंट का जवाब दिया जा सकता है. कारोबारों और अन्य लोकप्रिय जगहों की गाइड देखें.

अन्य इवेंट

GMSMapViewDelegate पर उपलब्ध सभी तरीकों के बारे में जानने के लिए, रेफ़रंस गाइड देखें.