您可以使用 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; }