GMSUISettings 類別參考資料

GMSUISettings 類別參考資料

總覽

使用者介面的設定GMSMapView

公開成員函式

(void) - setAllGesturesEnabled:
 設定是否應啟用所有手勢的偏好設定 (預設) 或停用狀態。

資源

BOOLscrollGestures
 控管是否啟用捲動手勢 (預設) 或停用。
BOOLzoomGestures
 控管是否啟用縮放手勢 (預設) 或停用。
BOOLtiltGestures
 控管要啟用或停用傾斜手勢 (預設)。
BOOLrotateGestures
 控管要啟用或停用旋轉手勢 (預設)。
BOOLconsumesGesturesInView
 控制使用者在啟用手勢時,是否要完全消耗使用者的手勢GMSMapView (預設為 YES)。
BOOLcompassButton
 啟用或停用指南針。
BOOLmyLocationButton
 啟用或停用「我的位置」按鈕。
BOOLindoorPicker
 啟用 (預設) 或停用室內樓層選擇器。
BOOLallowScrollGesturesDuringRotateOrZoom
 控制是否可使旋轉和縮放手勢離開中心外並捲動 (預設值為 YES)。
BOOLnavigationHeaderEnabled
 啟用或停用導覽標頭。
BOOLnavigationFooterEnabled
 啟用或停用導覽頁尾。
BOOLnavigationTripProgressBarEnabled
 啟用或停用導航進度列。
BOOLrecenterButtonEnabled
 啟用或停用「重新置中」按鈕。
BOOLshowsIncidentCards
 指出使用者輕觸事故圖示 (例如道路封閉) 時,是否會在地圖頂端顯示事故詳細資料。
BOOLshowsDestinationMarkers
 是否顯示路線的目的地標記。
BOOLshowsTrafficLights
 是否要在導航期間顯示路線上的紅綠燈。
BOOLshowsStopSigns
 是否要在導航期間顯示路線上的停靠站。
UIColor * navigationHeaderPrimaryBackgroundColor
 導覽標題使用的主要背景顏色。
UIColor * navigationHeaderSecondaryBackgroundColor
 導覽標題使用的次要背景顏色。
CGFloatnavigationHeaderBackgroundAlpha
 導覽標頭檢視畫面的 Alpha 值。
UIColor * navigationHeaderPrimaryBackgroundColorNightMode
 導覽標題在夜間模式下顯示目前步驟時,導覽標題的主要背景顏色。
UIColor * navigationHeaderSecondaryBackgroundColorNightMode
 在夜間模式下,導覽標題顯示目前步驟時,導覽標題的次要背景顏色。
UIColor * navigationHeaderLargeManeuverIconColor
 主要導覽標題檢視畫面中的操作圖示顏色。
UIColor * navigationHeaderSmallManeuverIconColor
 下一個轉彎導覽標題檢視畫面中的操作圖示顏色。
UIColor * navigationHeaderGuidanceRecommendedLaneColor
 建議車道或車道的顏色。
UIColor * navigationHeaderNextStepTextColor
 導覽標題顯示目前步驟時,下一個步驟標題中的文字顏色。
UIFont * navigationHeaderNextStepFont
 下一個步驟標題中的文字字型。
UIColor * navigationHeaderDistanceValueTextColor
 導航標題顯示目前步驟時,距離值的文字顏色。
UIFont * navigationHeaderDistanceValueFont
 距離值的文字字型。
UIColor * navigationHeaderDistanceUnitsTextColor
 導航標題顯示目前步驟時,距離單位的文字顏色。
UIFont * navigationHeaderDistanceUnitsFont
 距離單位的文字字型。
UIColor * navigationHeaderInstructionsTextColor
 操作說明部分的文字顏色。
UIFont * navigationHeaderInstructionsFirstRowFont
 操作說明部分第一列的文字字型。
UIFont * navigationHeaderInstructionsSecondRowFont
 操作說明部分第二列的文字字型。
UIFont * navigationHeaderInstructionsConjunctionsFont
 操作說明一節中連接詞的文字字型。
GMSNavigationSpeedometerUIOptionsspeedometerUIOptions
 根據速度快訊嚴重性設定速度計 UI 設定。

成員函式說明文件

- (void) setAllGesturesEnabled: (BOOL)  已啟用

設定是否應啟用所有手勢的偏好設定 (預設) 或停用狀態。

這不會限制使用者輕觸畫面上的任何按鈕來移動相機 (例如指南針或縮放控制項),也不會限製程式輔助動作和動畫。


屬性說明文件

- (BOOL) scrollGestures [read, write, assign]

控管是否啟用捲動手勢 (預設) 或停用。

如果啟用,使用者就可以拖曳來平移相機。但攝影機的程式輔助移動方式也不會受到限制。

- (BOOL) zoomGestures [read, write, assign]

控管是否啟用縮放手勢 (預設) 或停用。

如果啟用,用戶可以輕觸兩下/雙指輕觸畫面,或以雙指撥動縮放相機。但攝影機的程式輔助移動方式也不會受到限制。

- (BOOL) tiltGestures [read, write, assign]

控管要啟用或停用傾斜手勢 (預設)。

如果啟用,使用者可透過雙指垂直向下或向上滑動來傾斜相機。這不會限制攝影機的 viewAngle 的程式控制設定。

- (BOOL) rotateGestures [read, write, assign]

控管要啟用或停用旋轉手勢 (預設)。

如果啟用,使用者可使用雙指旋轉手勢旋轉相機。但不會限制攝影機方位的程式輔助控制。

- (BOOL) consumesGesturesInView [read, write, assign]

控制使用者在啟用手勢時,是否要完全消耗使用者的手勢GMSMapView (預設為 YES)。

如此一來,父項檢視畫面就不會收到這些手勢。

如果GMSMapView包含 UIScrollView (或其他可捲動的區域) 所包含,表示地圖上的手勢不會額外當做捲動手勢使用。不過,停用此屬性 (設為 NO) 可能有助於支援複雜的檢視區塊階層或需求。

- (BOOL) compassButton [read, write, assign]

啟用或停用指南針。

指南針是地圖上的圖示,用來指出地圖上的北方方向。

如果啟用,只有在相機從預設方向旋轉 (邊框為 0) 時,才會顯示此圖示。使用者輕觸指南針後,相機會切換成預設方向,不久後就會消失。如果停用,系統就不會顯示指南針。

- (BOOL) myLocationButton [read, write, assign]

啟用或停用「我的位置」按鈕。

這是地圖上的這個按鈕,使用者輕觸地圖後,地圖就會在目前的使用者位置置中。

- (BOOL) indoorPicker [read, write, assign]

啟用 (預設) 或停用室內樓層選擇器。

啟用時,只有在檢視焦點位於有室內樓層資料的建築物時,系統才會顯示影像。如果停用這個選項,仍可透過室內 Display mapView 屬性,以程式輔助方式控制所選樓層。

- (BOOL) allowScrollGesturesDuringRotateOrZoom [read, write, assign]

控制是否可使旋轉和縮放手勢離開中心外並捲動 (預設值為 YES)。

- (BOOL) navigationHeaderEnabled [read, write, assign]

啟用或停用導覽標頭。

標題會在地圖頂端顯示指引。預設為 YES。

- (BOOL) navigationFooterEnabled [read, write, assign]

啟用或停用導覽頁尾。

頁尾會在地圖底部顯示距離和預計到達時間資訊。預設為 YES。

- (BOOL) navigationTripProgressBarEnabled [read, write, assign]

啟用或停用導航進度列。

行程進度列會在地圖尾端的線性檢視畫面中,顯示前方的行程詳細資料。預設為 NO。

- (BOOL) recenterButtonEnabled [read, write, assign]

啟用或停用「重新置中」按鈕。

如果設為 YES,表示如果攝影機目前未追蹤使用者位置,或是攝影機處於追蹤狀態,但縮放與預設值有明顯差異,就會顯示「最近時間」按鈕。預設為 YES。

- (BOOL) showsIncidentCards [read, write, assign]

指出使用者輕觸事故圖示 (例如道路封閉) 時,是否會在地圖頂端顯示事故詳細資料。

預設為 YES。

- (BOOL) showsDestinationMarkers [read, write, assign]

是否顯示路線的目的地標記。

預設為 YES。

- (BOOL) showsTrafficLights [read, write, assign]

是否要在導航期間顯示路線上的紅綠燈。

對這項設定所做的變更只會在後續的路徑要求生效。

套用這項設定後,使用者介面會在導航期間隨時顯示前 3 個即將亮起的紅燈或停車標誌 (前提是有相關資料)。

預設值為 NO。

- (BOOL) showsStopSigns [read, write, assign]

是否要在導航期間顯示路線上的停靠站。

對這項設定所做的變更只會在後續的路徑要求生效。

套用這項設定後,使用者介面會在導航期間隨時顯示前 3 個即將亮起的紅燈或停車標誌 (前提是有相關資料)。

預設值為 NO。

- (UIColor*) navigationHeaderPrimaryBackgroundColor [read, write, copy]

導覽標題使用的主要背景顏色。

預設值為 nil。此屬性的值為 nil 時,將使用綠色做為主要背景顏色。

- (UIColor*) navigationHeaderSecondaryBackgroundColor [read, write, copy]

導覽標題使用的次要背景顏色。

顯示為下一個轉彎和車道指引下拉式選單的背景顏色。預設值為 nil。此屬性的值為 nil 時,會使用深綠色做為次要背景顏色。提供的 UIColor 必須位於支援 [UIColor getRed:green:blue:alpha] 的色彩空間,否則系統會忽略。

- (CGFloat) navigationHeaderBackgroundAlpha [read, write, assign]

導覽標頭檢視畫面的 Alpha 值。

預設值為 1.0f (完全不透明)。

- (UIColor*) navigationHeaderPrimaryBackgroundColorNightMode [read, write, copy]

導覽標題在夜間模式下顯示目前步驟時,導覽標題的主要背景顏色。

預設值為 nil。當此屬性的值為 nil 時,將會使用 navigationHeaderPrimaryBackgroundColor

- (UIColor*) navigationHeaderSecondaryBackgroundColorNightMode [read, write, copy]

在夜間模式下,導覽標題顯示目前步驟時,導覽標題的次要背景顏色。

預設值為 nil。當此屬性的值為 nil 時,將會使用 navigationHeaderSecondaryBackgroundColor

- (UIColor*) navigationHeaderLargeManeuverIconColor [read, write, copy]

主要導覽標題檢視畫面中的操作圖示顏色。

- (UIColor*) navigationHeaderSmallManeuverIconColor [read, write, copy]

下一個轉彎導覽標題檢視畫面中的操作圖示顏色。

- (UIColor*) navigationHeaderGuidanceRecommendedLaneColor [read, write, copy]

建議車道或車道的顏色。

預設為白色。只有在導覽標題顯示目前的導覽步驟時,才會考慮這個屬性。請注意,其他車道 (駕駛人不應採取的車道) 會自動標上灰色的次要背景顏色,

- (UIColor*) navigationHeaderNextStepTextColor [read, write, copy]

導覽標題顯示目前步驟時,下一個步驟標題中的文字顏色。

預設值為 nil。如果此屬性的值為 nil,或在導覽顯示任何其他步驟時,會使用白色。

- (UIFont*) navigationHeaderNextStepFont [read, write, copy]

下一個步驟標題中的文字字型。

預設值為 nil。如果此屬性的值為 nil,則使用 16.0f 大小的系統字型。

- (UIColor*) navigationHeaderDistanceValueTextColor [read, write, copy]

導航標題顯示目前步驟時,距離值的文字顏色。

預設值為 nil。如果此屬性的值為 nil,或在導覽顯示任何其他步驟時,會使用白色。

- (UIFont*) navigationHeaderDistanceValueFont [read, write, copy]

距離值的文字字型。

預設值為 nil。此屬性的值為 nil 時,將使用 24.0f 大小的系統粗體。

- (UIColor*) navigationHeaderDistanceUnitsTextColor [read, write, copy]

導航標題顯示目前步驟時,距離單位的文字顏色。

預設值為 nil。如果此屬性的值為 nil,或導航顯示任何其他步驟時,便會使用灰色。

- (UIFont*) navigationHeaderDistanceUnitsFont [read, write, copy]

距離單位的文字字型。

預設值為 nil。如果此屬性的值為 nil,則使用 18.0f 大小的系統字型。

- (UIColor*) navigationHeaderInstructionsTextColor [read, write, copy]

操作說明部分的文字顏色。

預設值為 nil。此屬性的值為 nil 時,將會使用白色。

- (UIFont*) navigationHeaderInstructionsFirstRowFont [read, write, copy]

操作說明部分第一列的文字字型。

預設值為 nil。此屬性的值為 nil 時,會使用 30 大小的系統粗體。

- (UIFont*) navigationHeaderInstructionsSecondRowFont [read, write, copy]

操作說明部分第二列的文字字型。

預設值為 nil。此屬性的值為 nil 時,會使用 24 大小的系統粗體。

- (UIFont*) navigationHeaderInstructionsConjunctionsFont [read, write, copy]

操作說明一節中連接詞的文字字型。

預設值為 nil。當此屬性的值為 nil 時,將會使用大小為 18 的系統粗體字型。

根據速度快訊嚴重性設定速度計 UI 設定。

你可以設定GMSNavigationSpeedometerUIOptions,清除前一個設定 (如果已設定)。未設定 GMSNavigationSpeedometerUIOptions 時,速度快訊 UI 回退至 NavSDK 預設設定:

  • 日間模式的小速警報:紅色文字搭配白色背景。
  • 夜間模式下的小型車速警報:紅色文字搭配深色背景。
  • 日間模式的重要速度警報:白色文字搭配紅色背景。
  • 夜間模式下的重大速度警報:白色文字搭配紅色背景。