Com o SDK do Maps para iOS, você pode detectar eventos que ocorrem na mapa, como eventos de mudança de câmera ou de toque no marcador.
Introdução
Para detectar eventos, você precisa implementar o
GMSMapViewDelegate
. Normalmente, você implementa
esse protocolo no controlador de visualização que exibe o mapa. Veja um exemplo abaixo:
Swift
import GoogleMaps class Events: UIViewController, GMSMapViewDelegate { // ... }
Objective-C
@import GoogleMaps; @interface Events : UIViewController <GMSMapViewDelegate> @end
Quando a GMSMapView
é criada, você pode definir o delegado dela como sua visualização.
de controle de acesso. O GMSMapViewDelegate
oferece apenas métodos opcionais. Para ouvir
a qualquer evento específico, é necessário implementar o método relevante.
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); }
Posição da câmera
Com o GMSMapViewDelegate
, é possível detectar mudanças na posição da câmera.
usada para renderizar o mapa. Há três eventos distintos:
mapView:willMove:
indica que a posição da câmera está prestes a mudar. Se o argumentogesture
estiver definido comoYES
, isso se deve à execução de um usuário um gesto natural noGMSMapView
, como deslocamento ou inclinação. Caso contrário,NO
indica que isso faz parte de uma mudança programática. por exemplo, usando métodos comoanimateToCameraPosition:
ou atualizando camada do mapa. Também pode serNO
se um usuário tocar no botão "My" Botões de localização ou bússola, que geram animações que mudam a câmera.Esse método pode ser chamado várias vezes antes
mapView:idleAtCameraPosition:
é invocado, embora isso normalmente acontece apenas se animações e gestos ocorrerem ao mesmo tempo - um gesto cancelará qualquer animação atual, por exemplo, e chamarámapView:willMove:
pela segunda vez.mapView:didChangeCameraPosition:
é chamado repetidamente durante um gesto ou animação, sempre após uma chamada paramapView:willMove:
. O parâmetro na posição intermediária da câmera.Por fim,
mapView:idleAtCameraPosition:
é invocado quando a posição da câmera é noGMSMapView
fica inativo e especifica a posição relevante da câmera. Nesse momento, todas as animações e gestos foram interrompidos.Os aplicativos podem usar esse evento para acionar uma atualização de marcadores ou outras conteúdo sendo mostrado no
GMSMapView
, em vez de, por exemplo, recarregando o conteúdo em cada mudança de câmera.
Por exemplo, um aplicativo pode limpar a GMSMapView
ao mover e depois
geocodificação inversa da posição em que a câmera fica em repouso.
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]; }
Eventos em pontos de interesse comerciais e de outros tipos
Por padrão, os pontos de interesse (POIs, na sigla em inglês) aparecem no mapa de base junto com seus respectivos ícones. Os POIs incluem parques, escolas, estabelecimentos do governo e outros, além de POIs comerciais, como lojas, restaurantes e hotéis.
Você pode responder a eventos de clique em um PDI. Consulte o guia sobre pontos de interesse comerciais e de outros tipos.
Outros eventos
Para saber mais sobre a lista completa de métodos no GMSMapViewDelegate
, consulte
guia de referência.