Мероприятия

Используя Maps SDK для iOS, вы можете прослушивать события, происходящие на карте, например события смены камеры или события касания маркера.

Введение

Чтобы прослушивать события, необходимо реализовать протокол 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: . Ему передается промежуточное положение камеры.

• Наконец, mapView:idleAtCameraPosition: вызывается, когда положение камеры в GMSMapView становится неактивным, и определяет соответствующее положение камеры. На этом этапе все анимации и жесты остановились.

  Приложения могут использовать это событие для запуска обновления маркеров или другого содержимого, отображаемого в 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];
}
      

Деловые мероприятия и другие интересные места

По умолчанию точки интереса (POI) отображаются на базовой карте вместе с соответствующими значками. К POI относятся парки, школы, правительственные здания и т. д., а также бизнес-POI, например магазины, рестораны и отели.

Вы можете реагировать на события кликов в POI. См. путеводитель по предприятиям и другим достопримечательностям .

Другие события

Чтобы узнать о полном списке методов GMSMapViewDelegate , смотрите справочное руководство .