Wydarzenia

Dzięki pakietowi Maps SDK na iOS możesz nasłuchiwać zdarzeń, które występują na mapie, takich jak zdarzenia zmiany kamery czy zdarzenia kliknięcia znacznika.

Wprowadzenie

Aby nasłuchiwać zdarzeń, musisz zaimplementować protokół GMSMapViewDelegate. Protokół ten zwykle implementuje się w kontrolerze widoku, który wyświetla mapę. Oto przykład:

import GoogleMaps

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

@import GoogleMaps;

@interface Events : UIViewController <GMSMapViewDelegate>

@end
      

Po utworzeniu GMSMapView możesz ustawić jego delegata na kontroler widoku. GMSMapViewDelegate udostępnia tylko metody opcjonalne. Aby nasłuchiwać konkretnego zdarzenia, musisz zaimplementować odpowiednią metodę.

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

Pozycja kamery

Za pomocą GMSMapViewDelegate możesz nasłuchiwać zmian pozycji kamery używanej do renderowania mapy. Wyróżniamy 3 różne zdarzenia.

• mapView:willMove: wskazuje, że pozycja kamery ma się zmienić. Jeśli argument gesture jest ustawiony na YES, oznacza to, że użytkownik wykonuje naturalny gest na GMSMapView, np. przesuwa lub przechyla mapę. W przeciwnym razie NO wskazuje, że jest to część zmiany programowej, np. za pomocą metod takich jak animateToCameraPosition: lub bezpośredniej aktualizacji warstwy mapy. Może to być też NO, jeśli użytkownik kliknął przyciski Moja lokalizacja lub kompas, które generują animacje zmieniające kamerę.

  Ta metoda może być wywoływana kilka razy, zanim zostanie wywołana metoda mapView:idleAtCameraPosition:, ale zwykle dzieje się tak tylko wtedy, gdy animacje i gesty występują w tym samym czasie. Na przykład gest anuluje bieżącą animację i wywoła metodę mapView:willMove: po raz drugi.

• mapView:didChangeCameraPosition: jest wywoływana wielokrotnie podczas gestu lub animacji, zawsze po wywołaniu mapView:willMove:. Przekazuje ona pośrednią pozycję kamery.

• Na koniec wywoływana jest metoda mapView:idleAtCameraPosition:, gdy pozycja kamery na GMSMapView stanie się bezczynna, i określa odpowiednią pozycję kamery. W tym momencie wszystkie animacje i gesty zostały zatrzymane.

  Aplikacje mogą używać tego zdarzenia do wywoływania odświeżania znaczników lub innych treści wyświetlanych na GMSMapView, zamiast np. przeładowywać treści przy każdej zmianie kamery.

Na przykład aplikacja może wyczyścić GMSMapView podczas przesuwania, a następnie przeprowadzić geokodowanie wsteczne pozycji, w której kamera się zatrzyma.

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

Zdarzenia dotyczące firm i innych ważnych miejsc

Domyślnie ważne miejsca (POI) są wyświetlane na mapie podstawowej wraz z odpowiadającymi im ikonami. POI obejmują parki, szkoły, budynki rządowe i inne miejsca, a także POI firmowe, takie jak sklepy, restauracje i hotele.

Możesz reagować na zdarzenia kliknięcia POI. Zapoznaj się z przewodnikiem po firmach i innych ważnych miejscach.

Inne zdarzenia

Pełną listę metod w GMSMapViewDelegate znajdziesz w przewodniku.