控制項和手勢

選取平台： Android iOS JavaScript

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

地圖控制項

Maps SDK for iOS 提供一些內建 UI 控制項，與 Google 地圖 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;
}