Korzystając z pakietu Maps SDK na iOS, możesz nasłuchiwać zdarzeń występujących na mapie, takich jak zmiana kamery czy kliknięcie znacznika.
Wstęp
Aby nasłuchiwać zdarzeń, musisz wdrożyć protokół GMSMapViewDelegate
. Ten protokół zazwyczaj implementujesz na kontrolerze widoku, który wyświetla mapę. Oto przykład:
Swift
import GoogleMaps class Events: UIViewController, GMSMapViewDelegate { // ... }
Objective-C
@import GoogleMaps; @interface Events : UIViewController <GMSMapViewDelegate> @end
Po utworzeniu obiektu GMSMapView
możesz wyznaczyć jego przedstawiciela do kontrolera widoku. GMSMapViewDelegate
udostępnia tylko metody opcjonalne. Aby nasłuchiwać dowolnych zdarzeń, musisz wdrożyć odpowiednią metodę.
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); }
Pozycja kamery
Za pomocą GMSMapViewDelegate
możesz nasłuchiwać zmian pozycji kamery używanych do renderowania mapy. Istnieją 3 różne zdarzenia.
mapView:willMove:
oznacza, że pozycja kamery wkrótce się zmieni. Jeśli argumentgesture
ma wartośćYES
, oznacza to, że użytkownik wykonuje naturalny gest na elemencieGMSMapView
, np. przesuwa lub przechyla. W przeciwnym razie atrybutNO
oznacza, że jest to część zmiany automatycznej, np. za pomocą metod takich jakanimateToCameraPosition:
lub bezpośrednio aktualizowania warstwy mapy. Wartość ta może być również ustawiona naNO
, jeśli użytkownik kliknie przycisk Moja lokalizacja lub przycisk kompasu, co spowoduje wygenerowanie animacji zmieniających aparat.Ta metoda może być wywoływana kilka razy przed wywołaniem funkcji
mapView:idleAtCameraPosition:
, ale zwykle dzieje się tak tylko wtedy, gdy animacje i gesty są wykonywane w tym samym czasie. Gest na przykład anuluje bieżącą animację i wywoła metodęmapView:willMove:
po raz drugi.Funkcja
mapView:didChangeCameraPosition:
jest wywoływana wielokrotnie podczas gestu lub animacji, zawsze po wywołaniumapView:willMove:
. Jest ona przekazywana do pośredniego położenia kamery.Na koniec funkcja
mapView:idleAtCameraPosition:
jest wywoływana, gdy pozycja kamery naGMSMapView
stanie się bezczynna, i określi odpowiednie położenie kamery. Od tego momentu wszystkie animacje i gesty zostały zatrzymane.Aplikacje mogą używać tego zdarzenia do wywołania odświeżania znaczników lub innych treści wyświetlanych w
GMSMapView
, zamiast na przykład ponownie wczytywać treści po każdej zmianie kamery.
Aplikacja może na przykład wyczyścić pole GMSMapView
podczas ruchu, a następnie przetworzyć dane geograficzne odwrotne do pozycji, na której spoczywa kamera.
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]; }
Wydarzenia w firmach i innych ciekawych miejscach
Domyślnie ciekawe miejsca (POI) są wyświetlane na mapie podstawowej wraz z odpowiednimi ikonami. Ważne miejsca obejmują parki, szkoły, budynki administracji publicznej i inne miejsca, a także miejsca związane z biznesem, takie jak sklepy, restauracje i hotele.
Możesz odpowiadać na zdarzenia kliknięcia związane z ważnym miejscem. Zobacz przewodnik po firmach i innych ciekawych miejscach.
Inne zdarzenia
Pełną listę metod w GMSMapViewDelegate
znajdziesz w przewodniku.