Ereignisse

Plattform auswählen: Android iOS JavaScript

Mit dem Maps SDK for iOS können Sie auf Ereignisse auf der Karte warten, z. B. Kameraänderungen oder Tippereignisse.

Einführung

Wenn Sie auf Ereignisse warten möchten, müssen Sie das GMSMapViewDelegate-Protokoll implementieren. In der Regel implementieren Sie dieses Protokoll auf dem Ansichts-Controller, der die Karte anzeigt. Ein Beispiel dafür sehen Sie unten:

Swift

import GoogleMaps

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

Objective-C

@import GoogleMaps;

@interface Events : UIViewController <GMSMapViewDelegate>

@end
      

Nachdem die GMSMapView erstellt wurde, können Sie ihren Bevollmächtigten an Ihren View Controller festlegen. GMSMapViewDelegate bietet nur optionale Methoden. Um auf ein bestimmtes Ereignis zu warten, müssen Sie die entsprechende Methode implementieren.

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

Kameraposition

Mit GMSMapViewDelegate kannst du Änderungen an der Kameraposition erfassen, die zum Rendern der Karte verwendet wird. Es können drei verschiedene Ereignisse auftreten.

• mapView:willMove: gibt an, dass sich die Kameraposition ändern wird. Wenn das Argument gesture auf YES gesetzt ist, bedeutet dies, dass der Nutzer eine natürliche Geste auf GMSMapView ausführt, z. B. Schwenken oder Neigen. Andernfalls gibt NO an, dass dies Teil einer programmatischen Änderung ist, z. B. über Methoden wie animateToCameraPosition: oder durch direktes Aktualisieren der Kartenebene. Dieser kann auch NO sein, wenn ein Nutzer auf die Schaltfläche „Mein Standort“ oder auf die Kompassschaltfläche getippt hat, die Animationen generieren, durch die die Kamera gewechselt wird.

  Diese Methode kann mehrmals aufgerufen werden, bevor mapView:idleAtCameraPosition: aufgerufen wird. Normalerweise geschieht dies jedoch nur, wenn Animationen und Touch-Gesten gleichzeitig auftreten. Durch eine Geste wird z. B. jede aktuelle Animation abgebrochen und mapView:willMove: ein zweites Mal aufgerufen.

• mapView:didChangeCameraPosition: wird während einer Geste oder Animation wiederholt aufgerufen, immer nach einem mapView:willMove:-Aufruf. Dabei wird die Zwischenposition der Kamera übergeben.

• mapView:idleAtCameraPosition: wird aufgerufen, sobald die Kameraposition auf GMSMapView inaktiv wird, und gibt die entsprechende Kameraposition an. An diesem Punkt finden keine Animationen und Gesten mehr statt.

  Apps können dieses Ereignis verwenden, um eine Aktualisierung von Markierungen oder anderen Inhalten auszulösen, die im GMSMapView angezeigt werden, anstatt z. B. den Inhalt bei jeder Kameraänderung neu zu laden.

Eine Anwendung kann beispielsweise bei einer Bewegung den GMSMapView löschen und dann die Position, auf die die Kamera zur Position kommt, umgekehrt geocodieren.

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

Ereignisse bei Unternehmen und anderen POIs

Standardmäßig werden Points of Interest (POIs) zusammen mit ihren Icons auf der Karte dargestellt. POIs sind beispielsweise Parks, Schulen, Behördengebäude und mehr sowie Wirtschaftsunternehmen wie Geschäfte, Restaurants oder Hotels.

Sie können auf Klickereignisse auf einen POI reagieren. Weitere Informationen findest du im Leitfaden zu Unternehmen und anderen POIs.

Weitere Ereignisse

Eine vollständige Liste der Methoden für GMSMapViewDelegate finden Sie in der Referenz.