控制項和手勢

選取平台： Android iOS JavaScript

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

地圖控制項

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

指南針

在某些情況下，Maps SDK for iOS 會提供指南針圖形。只有在攝影機朝向非零航向的方向時，指南針才會顯示。使用者按一下指南針後，攝影機會移動回航向零的位置 (預設方向)，指南針隨後也會消失。

指南針預設為停用。只要將 GMSUISettings 的 compassButton 屬性設為 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;

我的位置按鈕

只有在「我的位置」按鈕已啟用時，畫面右下角才會顯示「我的位置」按鈕。使用者按一下按鈕後，如果攝影機的所在地是已知的位置，相機會聚焦於使用者目前的位置。只要將 GMSUISettings 的 myLocationButton 屬性設為 YES 即可啟用按鈕。

Swift

mapView.settings.myLocationButton = true

Objective-C

mapView.settings.myLocationButton = YES;

樓層選擇器

當室內地圖醒目顯示時，樓層選擇器控制項就顯示在畫面右下方。系統顯示兩張以上的室內地圖時，樓層選擇器會與與畫面中央最近的建築物相關。每個建築物都有預設樓層，首次顯示挑選器時就會選取。您可以從挑選器中選擇其他樓層。

如要停用樓層選擇器控制，請將 GMSUISettings 的 indoorPicker 屬性設為 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;
}