Controles e gestos

Selecione a plataforma: Android iOS JavaScript

Com o SDK do Maps para iOS, você pode personalizar a forma como os usuários interagem com o mapa, determinando quais componentes integrados da interface aparecem no mapa e quais gestos são permitidos.

Controles do mapa

O SDK do Maps para iOS oferece alguns controles de interface integrados semelhantes aos encontrados no app Google Maps para iOS. É possível alternar a visibilidade desses controles usando a classe GMSUISettings. As alterações feitas nessa classe são aplicadas imediatamente ao mapa.

Bússola

O SDK do Maps para iOS fornece um gráfico de bússola que aparece no canto superior direito do mapa em determinadas circunstâncias. A bússola só é exibida quando a câmera está orientada com um rolamento diferente de zero. Quando o usuário clica na bússola, a câmera volta para uma posição com direção zero (orientação padrão) e a bússola desaparece pouco tempo depois.

Por padrão, a bússola é desativada. É possível ativar a bússola definindo a propriedade compassButton de GMSUISettings como YES. No entanto, não é possível forçar a exibição permanente dela.

Swift

let camera = GMSCameraPosition(latitude: 37.757815, longitude: -122.50764, zoom: 12)
let mapView = GMSMapView(frame: .zero, camera: camera)
mapView.settings.compassButton = true

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:37.757815
                                                        longitude:-122.50764
                                                             zoom:12];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
mapView.settings.compassButton = YES;

Botão "Meu local"

O botão "Meu local" aparece no canto inferior direito da tela somente quando está ativado. Quando um usuário clica no botão, a câmera passa a focar na localização atual do usuário, caso essa informação seja conhecida. Para ativar o botão, defina a propriedade myLocationButton de GMSUISettings como YES.

Swift

mapView.settings.myLocationButton = true

Objective-C

mapView.settings.myLocationButton = YES;

Seletor de andar

Ele aparece no canto inferior direito da tela sempre que um mapa interno aparece em destaque. Quando dois ou mais mapas desse tipo estão visíveis, o seletor de andar é associado ao edifício mais próximo do centro da tela. Cada edifício tem um andar padrão, que é escolhido quando o seletor é exibido pela primeira vez. Os usuários podem escolher um andar diferente selecionando-o no seletor.

Para desativar o controle do seletor de andar, defina a propriedade indoorPicker de GMSUISettings como NO.

Swift

mapView.settings.indoorPicker = false

Objective-C

mapView.settings.indoorPicker = NO;

Gestos do mapa

Para desativar os gestos padrão no mapa, defina as propriedades da classe GMSUISettings, que está disponível como uma propriedade de GMSMapView. Os gestos a seguir podem ser ativados e desativados programaticamente. Desativar o gesto não limita o acesso programático às configurações da câmera.

  • scrollGestures: controla se os gestos de rolagem estão ativados ou desativados. Se ativados, os usuários podem deslizar o dedo para deslocar a câmera.
  • zoomGestures: controla se os gestos de zoom estão ativados ou desativados. Se ativados, os usuários podem tocar duas vezes, tocar com dois dedos ou fazer gesto de pinça para aumentar o zoom da câmera. Tocar duas vezes ou fazer gesto de pinça quando scrollGestures estiver ativado pode mover a câmera até o ponto especificado.
  • tiltGestures: controla se os gestos de inclinação ficam ativados ou desativados. Se essa opção estiver ativada, os usuários poderão deslizar com dois dedos para baixo ou para cima para inclinar a câmera.
  • rotateGestures: controla se os gestos de rotação estão ativados ou desativados. Se ativada, os usuários podem usar um gesto de rotação com dois dedos para girar a câmera.

No exemplo a seguir, os gestos de deslocamento e zoom foram desativados.

Swift

override func loadView() {
  let camera = GMSCameraPosition.camera(
    withLatitude: 1.285,
    longitude: 103.848,
    zoom: 12
  )

  let mapView = GMSMapView.map(withFrame: .zero, camera: camera)
  mapView.settings.scrollGestures = false
  mapView.settings.zoomGestures = false
  self.view = mapView
}

Objective-C

- (void)loadView {
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:1.285
                                                          longitude:103.848
                                                               zoom:12];
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  mapView.settings.scrollGestures = NO;
  mapView.settings.zoomGestures = NO;
  self.view = mapView;
}