Com o SDK do Maps para iOS, é possível detectar eventos que ocorrem no mapa, como alteração da câmera ou toque no marcador.
Introdução
Para detectar eventos, é necessário implementar o protocolo
GMSMapViewDelegate
. Normalmente, esse protocolo é implementado
no controlador de visualizações 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 o GMSMapView
é criado, é possível definir o delegado como o controlador
de visualização. O GMSMapViewDelegate
oferece apenas métodos opcionais. Para detectar
um evento específico, é preciso 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
Usando 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 ser alterada. Se o argumentogesture
estiver definido comoYES
, isso se deve a um usuário executando 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 a camada do mapa diretamente.NO
também pode indicar que um usuário tocou nos botões My Location ou da bússola, gerando animações que mudam a câmera.Esse método pode ser chamado várias vezes antes que
mapView:idleAtCameraPosition:
seja invocado, embora isso normalmente aconteça apenas quando animações e gestos ocorrem ao mesmo tempo. Por exemplo, um gesto cancela qualquer animação atual e chamamapView:willMove:
pela segunda vez.mapView:didChangeCameraPosition:
é chamado repetidamente durante um gesto ou animação, sempre após uma chamada paramapView:willMove:
. A posição intermediária da câmera é transmitida.Por fim,
mapView:idleAtCameraPosition:
é invocado quando a posição da câmera emGMSMapView
fica ociosa 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 de outro conteúdo exibido na
GMSMapView
em vez de, por exemplo, recarregar o conteúdo em todas as alterações de câmera.
Por exemplo, um aplicativo pode limpar a GMSMapView
na movimentação e
reverter a geocodificação da posição em que a câmera ficou ociosa.
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 conferir a lista completa de métodos em GMSMapViewDelegate
, consulte
o guia de referência.