控制項和手勢

選取平台： Android iOS JavaScript

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

地圖控制選項

Maps SDK for iOS 提供一些內建的 UI 控制項，與 iOS 版 Google 地圖應用程式的控制項類似。您可以使用 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;
}