控制項和手勢

選取平台: Android iOS JavaScript

您可以使用 Maps SDK for iOS,指定要在地圖上顯示的內建 UI 元件及允許的手勢,藉此自訂使用者與地圖的互動方式。

地圖控制項

Maps SDK for iOS 提供部分內建 UI 控制項,與 Google 地圖 iOS 版應用程式中的控制項類似。您可以使用 GMSUISettings 類別來切換這些控制項的顯示設定。就這一類的變化會立即反映在地圖上。

指南針

Maps SDK for iOS 會在特定情況下,於地圖右上角顯示指南針圖像。只有在攝影機朝向非零航向時,指南針才會顯示。使用者按一下指南針後,攝影機會移動回航向為零的方向 (預設方向),指南針隨後也會消失。

指南針預設為停用。只要將 GMSUISettingscompassButton 屬性設為 YES,即可啟用指南針。不過,您無法強制指南針持續顯示。

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;
      

我的位置按鈕

只有在「我的位置」按鈕已啟用時,畫面右上角才會顯示「我的位置」按鈕。使用者按一下該按鈕後,攝影機會著重於使用者的目前位置,前提是使用者的位置目前已知。只要將 GMSUISettingsmyLocationButton 屬性設為 YES,即可啟用該按鈕。

Swift

mapView.settings.myLocationButton = true
      

Objective-C

mapView.settings.myLocationButton = YES;
      

樓層選擇器

有顯眼的地圖進駐地圖時,背景挑選器控制項會顯示在畫面右下方。系統顯示兩張以上的室內地圖時,樓層挑選器與靠近畫面中央的建築物相關。每次建構顯示畫面時,都會選取預設樓層。你可以從挑選器中選擇其他樓層。

如要停用樓層挑選器控制項,請將 GMSUISettingsindoorPicker 屬性設為 NO

Swift

mapView.settings.indoorPicker = false
      

Objective-C

mapView.settings.indoorPicker = NO;
      

地圖手勢

如要停用地圖上的預設手勢,請設定 GMSUISettings 類別的屬性 (為 GMSMapView 的屬性)。下面的手勢可以啟用和禁用編程。請注意,停用手勢不會限製程式輔助存取相機設定。

  • scrollGestures - 控制捲動手勢是否啟用。如果啟用,用戶可刷卡平移相機。
  • zoomGestures - 控制縮放手勢是否啟用。啟用後,使用者只要輕觸兩下、輕觸兩下或雙指撥動即可縮放相機。請注意,啟用 scrollGestures 時,輕觸兩下或雙指撥動可能會將相機平移到指定的點。
  • tiltGestures - 控制傾斜手勢是否啟用。啟用後,使用者可以使用兩指垂直或向上滑動,將相機傾斜。
  • rotateGestures - 控制是否啟用或停用旋轉手勢。如果啟用這個選項,使用者就可以使用雙指旋轉手勢來旋轉相機。

在下例中,平移和縮放手勢都已停用。

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;
}