Controles e gestos

Com o SDK do Maps para iOS, você personaliza como os usuários interagem com seu 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 controles de interface integrados semelhantes aos do app Google Maps para iOS. Para alterar a visibilidade desses controles, use a classe GMSUISettings. As alterações feitas nessa classe são aplicadas imediatamente ao mapa.

Bússola

O SDK do Maps para iOS fornece uma imagem de bússola que aparece no canto superior direito do mapa em circunstâncias específicas. A bússola só é exibida quando a câmera está orientada com uma direção 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. Para ativar a bússola, defina a propriedade compassButton de GMSUISettings como YES. No entanto, não é possível forçar a exibição permanente dela.

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

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:37.757815
                                                        longitude:-122.50764
                                                             zoom:12];
GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = camera;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
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 se move para focar na localização atual do usuário, se ela for conhecida. Para ativar o botão, defina a propriedade myLocationButton de GMSUISettings como YES.

mapView.settings.myLocationButton = true
      

mapView.settings.myLocationButton = YES;
      

Seletor de andar

O controle do seletor de andar aparece perto do canto inferior direito da tela sempre que um mapa interno é exibido em destaque. Quando dois ou mais mapas internos estão visíveis, o seletor de andar se refere ao edifício mais próximo do centro da tela. Cada edifício tem um andar padrão, que é escolhido quando o seletor aparece 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.

mapView.settings.indoorPicker = false
      

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. A desativação do 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 ativado, os usuários podem tocar duas vezes, tocar com dois dedos ou fazer o gesto de pinça para ampliar a câmera. Se scrollGestures estiver ativado, tocar duas vezes ou fazer o gesto de pinça pode mover a câmera para o ponto especificado.
• tiltGestures: controla se os gestos de inclinação estão ativados ou desativados. Se ativado, os usuários podem deslizar dois dedos para cima ou para baixo 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.

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

  let options = GMSMapViewOptions()
  options.camera = camera
  let mapView = GMSMapView(options: options)
  mapView.settings.scrollGestures = false
  mapView.settings.zoomGestures = false
  self.view = mapView
}
      

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