Eventi

Con l'SDK Maps per iOS, puoi ascoltare gli eventi che si verificano sulla mappa, ad esempio eventi di cambio della videocamera o eventi di tocco dell'indicatore.

Introduzione

Per ascoltare gli eventi, devi implementare il protocollo GMSMapViewDelegate. In genere, si implementa questo protocollo sul controller di visualizzazione che mostra la mappa. Di seguito è riportato un esempio:

import GoogleMaps

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

@import GoogleMaps;

@interface Events : UIViewController <GMSMapViewDelegate>

@end
      

Quando viene creato l'oggetto GMSMapView, puoi impostare il suo delegato al controller di visualizzazione. GMSMapViewDelegate fornisce solo metodi facoltativi. Per ascoltare un determinato evento, devi implementare il metodo pertinente.

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

Posizione della fotocamera

Con GMSMapViewDelegate puoi ascoltare le modifiche alla posizione della fotocamera utilizzata per eseguire il rendering della mappa. Ci sono tre eventi distinti.

• mapView:willMove: indica che la posizione della fotocamera sta per cambiare. Se l'argomento gesture è impostato su YES, ciò è dovuto al fatto che un utente esegue un gesto naturale sull'GMSMapView, ad esempio una panoramica o un'inclinazione. In caso contrario, NO indica che fa parte di una modifica della pubblicità programmatica, ad esempio tramite metodi come animateToCameraPosition: o aggiornando direttamente il livello della mappa. Può anche essere NO se un utente ha toccato i pulsanti La mia posizione o Bussola, che generano animazioni che cambiano la fotocamera.

  Questo metodo può essere richiamato più volte prima che venga richiamato mapView:idleAtCameraPosition:, anche se questo in genere si verifica solo se le animazioni e i gesti vengono eseguiti contemporaneamente: un gesto annullerà qualsiasi animazione corrente, ad esempio, e chiamerà mapView:willMove: una seconda volta.

• mapView:didChangeCameraPosition: viene richiamato ripetutamente durante un gesto o un'animazione, sempre dopo una chiamata al numero mapView:willMove:. Ha superato la posizione intermedia della fotocamera.

• Infine, mapView:idleAtCameraPosition: viene richiamato quando la posizione della fotocamera su GMSMapView diventa inattiva e specifica la posizione della fotocamera pertinente. A questo punto, tutte le animazioni e i gesti sono stati interrotti.

  Le applicazioni possono utilizzare questo evento per attivare un aggiornamento degli indicatori o di altri contenuti visualizzati sul GMSMapView anziché, ad esempio, per ricaricare i contenuti a ogni cambio della videocamera.

Ad esempio, un'applicazione può cancellare GMSMapView in movimento e poi invertire il codice geografico della posizione in cui si trova la videocamera.

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

Eventi su attività commerciali e altri punti d'interesse

Per impostazione predefinita, i punti di interesse (PDI) vengono visualizzati sulla mappa di base insieme alle icone corrispondenti. I PDI includono parchi, scuole, edifici governativi e altro, oltre a PDI aziendali come negozi, ristoranti e hotel.

Puoi rispondere agli eventi di clic su un PDI. Consulta la guida per attività commerciali e altri punti d'interesse.

Altri eventi

Per conoscere l'elenco completo dei metodi su GMSMapViewDelegate, consulta la guida di riferimento.