इवेंट

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

परिचय

इवेंट सुनने के लिए, आपको GMSMapViewDelegate प्रोटोकॉल लागू करना होगा. आम तौर पर, मैप दिखाने वाले व्यू कंट्रोलर पर यह प्रोटोकॉल लागू किया जाता है. इसका उदाहरण यहां दिया गया है:

import GoogleMaps

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

@import GoogleMaps;

@interface Events : UIViewController <GMSMapViewDelegate>

@end
      

GMSMapView बनाने के बाद, उसके प्रतिनिधि को अपने व्यू कंट्रोलर पर सेट किया जा सकता है. GMSMapViewDelegate सिर्फ़ वैकल्पिक तरीके उपलब्ध कराता है. किसी खास इवेंट को सुनने के लिए, आपको उससे जुड़ा तरीका लागू करना होगा.

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)")
}
      

- (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 को मिटा सकता है. इसके बाद, कैमरे की उस जगह को रिवर्स जियोकोड कर सकता है जहां वह रुका है.

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

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