GoogleMapOptions

公開最終類別 GoogleMapOptions 可擴充物件
導入 Parcelable

定義 GoogleMap 的 GoogleMapOptions 設定。透過程式輔助 (而非 XML) 將地圖加入應用程式時,您可以使用這些選項。如果您使用 MapFragment,可以透過靜態工廠方法 newInstance(GoogleMapOptions) 傳遞這些選項。如果您使用的是 MapView,可以透過建構函式 MapView(Context, GoogleMapOptions) 傳遞這些選項。

如果您使用 XML 新增地圖,可以使用自訂 XML 標記套用這些選項。

繼承常數摘要

公用建構函式摘要

GoogleMapOptions()
建立新的 GoogleMapOptions 物件。

公用方法摘要

GoogleMapOptions
ambientEnabled(已啟用布林值)
指定是否應啟用微光模式樣式。
GoogleMapOptions
camera(CameraPosition 相機)
指定地圖的初始相機位置。
GoogleMapOptions
compassEnabled(已啟用布林值)
指定是否要啟用指南針。
靜態 GoogleMapOptions
createFromAttributes(情境內容、屬性集屬性)
AttributeSet 建立 GoogleMapsOptions。
布林值
CameraPosition
布林值
LatLngBounds
布林值
布林值
int
浮點值
浮點值
布林值
布林值
布林值
布林值
布林值
布林值
布林值
布林值
GoogleMapOptions
latLngBoundsForCameraTarget(LatLngBounds 範圍)
指定用來限制攝影機目標的 LatLngBounds,藉此讓使用者捲動及平移地圖時,攝影機目標不會在這些邊界外移動。
GoogleMapOptions
liteMode(啟用布林值)
指定是否應在精簡模式中建立地圖。
GoogleMapOptions
mapId(String mapId)
指定地圖的 ID。
GoogleMapOptions
mapToolbarEnabled(已啟用布林值)
指定是否應啟用 MapToolbar。
GoogleMapOptions
mapType(int mapType)
指定初始地圖類型的變更。
GoogleMapOptions
maxZoomPreference(float maxZoomPreference)
指定相機縮放的建議上限。
GoogleMapOptions
minZoomPreference(float minZoomPreference)
指定相機縮放的建議下限。
GoogleMapOptions
rotateGesturesEnabled(已啟用布林值)
指定是否應啟用旋轉手勢。
GoogleMapOptions
scrollGesturesEnabled(已啟用布林值)
指定是否應啟用捲動手勢。
GoogleMapOptions
scrollGesturesEnabledDuringRotateOrZoom(已啟用布林值)
指定是否要在旋轉和縮放手勢時啟用捲動手勢。
GoogleMapOptions
setInstrumentClusterMap(boolean isInstrumentCluster)
GoogleMapOptions
tiltGesturesEnabled(已啟用布林值)
指定是否應啟用傾斜手勢。
字串
GoogleMapOptions
useViewLifecycleInFragment(boolean useViewLifecycleInFragment)
使用 MapFragment 時,這個標記可指定地圖的生命週期應連結至片段的檢視畫面,還是片段本身。
GoogleMapOptions
zOrderOnTop(boolean zOrderOnTop)
控制是否將地圖檢視的介面置於其視窗上方。
GoogleMapOptions
zoomControlsEnabled(已啟用布林值)
指定是否要啟用縮放控制項。
GoogleMapOptions
zoomGesturesEnabled(已啟用布林值)
指定是否要啟用縮放手勢。

繼承方法摘要

公用建構函式

public GoogleMapOptions ()

建立新的 GoogleMapOptions 物件。

公用方法

public GoogleMapOptions ambientEnabled (boolean enabled)

指定是否應啟用微光模式樣式。預設值為 false。啟用之後,當 Ambiactive 裝置進入微光模式時,就會顯示微光樣式地圖。

參數
已啟用

公開 GoogleMapOptions 相機 (CameraPosition 相機)

指定地圖的初始相機位置。

參數
相機

public GoogleMapOptions compassEnabled (boolean enabled)

指定是否要啟用指南針。詳情請參閱 setCompassEnabled(boolean)。預設值為 true

參數
已啟用

公開 靜態 GoogleMapOptions createFromAttributes (情境內容、屬性集 attrs)

AttributeSet 建立 GoogleMapsOptions。

參數
context
attrs

公開布林值 getAmbientEnabled ()

傳回
  • AmbientEnabled 選項;若未指定,則傳回 null。

公開 CameraPosition getCamera ()

傳回
  • 相機選項,如果未指定,則會傳回 null。

公開布林值 getCompassEnabled ()

傳回
  • compassEnabled 選項,如果未指定,則傳回 null。

公開 LatLngBounds getLatLngBoundsForCameraTarget ()

傳回
  • 用來限制攝影機目標的 LatLngBounds,如果未指定,則傳回 null 。

公開布林值 getLiteMode ()

傳回
  • liteMode 選項,若未指定,則傳回 null 。

公開布林值 getMapToolbarEnabled ()

傳回
  • mapToolbarEnabled 選項,如果未指定,則傳回 null。

public int getMapType ()

傳回
  • mapType 選項,若未指定,則為 -1。

public Float getMaxZoomPreference ()

傳回
  • 最大縮放等級偏好設定,若未指定,則傳回 null 。

public Float getMinZoomPreference ()

傳回
  • 最小縮放等級偏好設定,如果未指定,則傳回 null 。

公開布林值 getRotateGesturesEnabled ()

傳回
  • yGesturesEnabled 選項,若未指定,則傳回 null。

公開布林值 getScrollGesturesEnabled ()

傳回
  • scrollGesturesEnabled 選項,若未指定,則傳回 null。

公開布林值 getScrollGesturesEnabledDuringRotateOrZoom ()

傳回
  • ScrollGesturesEnabledDuringRotateOrZoom 選項,如果未指定,則為 null。

公開布林值 getTiltGesturesEnabled ()

傳回
  • tiltGesturesEnabled 選項,如果未指定,則傳回 null。

公開布林值 getUseViewLifecycleInFragment ()

傳回
  • 使用 ViewLifecycleInFragment 選項,如果未指定,則傳回 null 。

公開布林值 getZOrderOnTop ()

傳回
  • zOrderOnTop 選項;如未指定,則為空值。

公開布林值 getZoomControlsEnabled ()

傳回
  • mapControlsEnabled 選項,如果未指定,則傳回 null。

公開布林值 getZoomGesturesEnabled ()

傳回
  • ZoomGesturesEnabled 選項,若未指定,則傳回 null。

public GoogleMapOptions latLngBoundsForCameraTarget (LatLngBounds llbounds)

指定用來限制攝影機目標的 LatLngBounds,如此一來,當使用者捲動及平移地圖時,攝影機目標就不會從這些邊界外移動。

詳情請參閱 setLatLngBoundsForCameraTarget(LatLngBounds)

參數
llbounds

public GoogleMapOptions liteMode (boolean enabled)

指定是否應在精簡模式中建立地圖。預設值為 false。如果啟用精簡模式,地圖將以靜態圖片載入。當需要同時顯示大量地圖 (例如捲動清單) 的情況,這樣做可提升效能,但精簡模式地圖無法由使用者平移或縮放,甚至根本無法傾斜或旋轉。

參數
已啟用

public GoogleMapOptions mapId (String mapId)

指定地圖的 ID。

參數
mapId

public GoogleMapOptions mapToolbarEnabled (boolean enabled)

指定是否應啟用 MapToolbar。詳情請參閱 setMapToolbarEnabled(boolean)。預設值為 true

參數
已啟用

public GoogleMapOptions mapType (int mapType)

指定初始地圖類型的變更。

參數
mapType

public GoogleMapOptions maxZoomPreference (float maxZoomPreference)

指定相機縮放的建議上限。

詳情請參閱 setMaxZoomPreference(float)

參數
maxZoomPreference

public GoogleMapOptions minZoomPreference (float minZoomPreference)

指定相機縮放的建議下限。

詳情請參閱 setMinZoomPreference(float)

參數
minZoomPreference

public GoogleMapOptions rotateGesturesEnabled (boolean enabled)

指定是否應啟用旋轉手勢。詳情請參閱 setRotateGesturesEnabled(boolean)。預設值為 true

參數
已啟用

public GoogleMapOptions scrollGesturesEnabled (boolean enabled)

指定是否應啟用捲動手勢。詳情請參閱 setScrollGesturesEnabled(boolean)。預設值為 true

參數
已啟用

public GoogleMapOptions scrollGesturesEnabledDuringRotateOrZoom (boolean enabled)

指定是否要在旋轉和縮放手勢時啟用捲動手勢。詳情請參閱 setScrollGesturesEnabledDuringRotateOrZoom(boolean)。預設值為 true

參數
已啟用

public GoogleMapOptions setInstrumentClusterMap (boolean isInstrumentCluster)

參數
isInstrumentCluster

public GoogleMapOptions tiltGesturesEnabled (boolean enabled)

指定是否應啟用傾斜手勢。詳情請參閱 setTiltGesturesEnabled(boolean)。預設值為 true

參數
已啟用

公開字串 toString ()

public GoogleMapOptions useViewLifecycleInFragment (boolean useViewLifecycleInFragment)

使用 MapFragment 時,這個標記可指定地圖的生命週期應連結至片段的檢視畫面,還是片段本身。預設值為 false,會將地圖的生命週期與片段結合。

由於系統會保留基礎 GL 結構定義,因此在卸離及重新附加片段時,使用片段的生命週期可加快地圖算繪速度。這會產生卸離片段 (但未刪除) 片段的費用,也不會釋出地圖使用的記憶體。

使用片段檢視畫面的生命週期,表示在卸離並重新附加片段時,不會重複使用地圖。這會導致地圖從頭開始重新算繪,這可能需要幾秒鐘的時間。這也表示,當片段卸離且因此沒有檢視畫面時,所有 GoogleMap 方法都會擲回 NullPointerException

參數
useViewLifecycleInFragment

public GoogleMapOptions zOrderOnTop (boolean zOrderOnTop)

Control whether the map view's surface is placed on top of its window. 詳情請參閱 setZOrderOnTop(boolean)。請注意,這項設定會涵蓋地圖上顯示的所有其他檢視畫面 (例如縮放控制項和「我的位置」按鈕)。

參數
zOrderOnTop

public GoogleMapOptions zoomControlsEnabled (boolean enabled)

指定是否要啟用縮放控制項。詳情請參閱 setZoomControlsEnabled(boolean)。預設值為 true

參數
已啟用

public GoogleMapOptions zoomGesturesEnabled (boolean enabled)

指定是否要啟用縮放手勢。詳情請參閱 setZoomGesturesEnabled(boolean)。預設值為 true

參數
已啟用