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 dos 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 que são semelhantes aos encontrados no aplicativo 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 oferece um gráfico de bússola que aparece canto superior direito do mapa em determinadas circunstâncias. A bússola só é exibida quando a câmera está orientada com um rumo diferente de zero. Quando o usuário clica na bússola, a câmera volta para uma posição com direção zero (a orientação padrão) e a bússola desaparece logo 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 da bússola.

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 apenas no canto inferior direito da tela quando o botão "Meu local" estiver ativado. Quando um usuário clica no botão, a a câmera é animada para focar na localização atual do usuário se esse local é conhecida atualmente. É possível ativar o botão definindo o Propriedade myLocationButton de GMSUISettings a YES.

Swift

mapView.settings.myLocationButton = true
      

Objective-C

mapView.settings.myLocationButton = YES;
      

Seletor de andar

O controle do seletor de andar aparece perto do canto inferior direito da tela sempre que um o mapa interno está em destaque. Quando dois ou mais mapas internos são visíveis, o seletor de andar relaciona-se ao edifício mais próximo do centro da tela. Cada o edifício tem um andar padrão, que é escolhido quando o seletor é iniciado exibidos. Os usuários podem escolher um andar diferente selecionando-o no seletor.

É possível desativar o controle do seletor de andar definindo a propriedade indoorPicker de GMSUISettings como NO.

Swift

mapView.settings.indoorPicker = false
      

Objective-C

mapView.settings.indoorPicker = NO;
      

Gestos do mapa

É possível desativar os gestos padrão no mapa, definindo propriedades do Classe GMSUISettings, que está disponível como uma propriedade do GMSMapView. Os gestos a seguir podem ser ativados e desativados programaticamente. Observe que a desativação do gesto não limita o acesso programático à câmera configurações.

  • scrollGestures: controla se os gestos de rolagem estão ativados ou desativado. 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 desativado. 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 ou fazer gesto de pinça duas vezes quando scrollGestures estiverem ativados, isso poderá movimentar a câmera até o ponto especificado.
  • tiltGestures: controla se os gestos de inclinação ficam ativados ou desativado. Se ativado, os usuários podem deslizar com dois dedos para baixo ou para cima para inclinar a câmera.
  • rotateGestures: controla se os gestos de rotação são ativados. ou desativado. Se ativado, os usuários podem usar um gesto de rotação com dois dedos para gire 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;
}