GoogleMap

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

包含主要街道透明圖層的衛星地圖。

沒有基本地圖圖塊。

基本地圖。

沒有標籤的衛星地圖。

地形地圖。

在此地圖中加入圓形。

在此地圖中加入圖片。

在這張地圖中加入標記。

標記的圖示會顯示在地圖上的位置 Marker.position 位置。按一下標記，即可將攝影機置於標記中心。如果已定義 Marker.title，地圖會顯示含有標記標題和摘要的資訊方塊。如果是可拖曳的標記，請長按標記再拖曳標記。

在此地圖中加入多邊形。

將折線加入此地圖。

在此地圖中新增圖塊疊加層。詳情請參閱 TileOverlay。

請注意，不同於其他疊加層，如果重新建立地圖，圖塊疊加層不會自動還原，必須手動重新加入。

為攝影機從目前位置到更新中定義的位置建立動畫效果。在動畫播放期間，對 getCameraPosition() 的呼叫會傳回攝影機的中繼位置。

如需一系列更新內容，請參閱 CameraUpdateFactory。

以動畫方式呈現相機從目前位置到更新中定義的位置，並在完成時呼叫選用的回呼。如需一系列更新，請參閱 CameraUpdateFactory。

在動畫播放期間，對 getCameraPosition() 的呼叫會傳回攝影機的中繼位置。

根據含有動畫的更新在指定時間內移動地圖，並在完成時呼叫選用的回呼。如需一系列更新，請參閱 CameraUpdateFactory。

如果在動畫期間呼叫 getCameraPosition()，則會傳回攝影機目前在飛行中的位置。

從地圖移除所有標記、折線、多邊形、疊加層等。

取得攝影機目前的位置。

傳回的 CameraPosition 是目前位置的快照，不會在攝影機移動時自動更新。

如要進一步瞭解如何變更攝影機位置，請參閱「攝影機和檢視畫面」。

取得目前聚焦的建築物。

取得目前顯示的地圖類型。如要查看可能的值，請參閱 MAP_TYPE_NORMAL、MAP_TYPE_SATELLITE 和 MAP_TYPE_TERRAIN。

傳回目前相機位置的最大縮放等級。系統會考量目前使用的地圖類型，例如衛星或地形提供的最高縮放等級可能低於基本地圖圖塊。

如要進一步瞭解如何變更相機的縮放等級，請參閱「相機和檢視畫面」。

傳回最小縮放等級。每個位置都是相同的 (最高縮放等級)，但不同裝置和地圖大小都可能不同。

如要進一步瞭解如何變更相機的縮放等級，請參閱「相機和檢視畫面」。

傳回目前顯示的使用者位置；如果沒有位置資料，則傳回 null。

傳回 Projection 物件，可用於在螢幕座標和經緯度座標之間進行轉換。

傳回的 Projection 是目前投影的快照，不會在攝影機移動時自動更新。由於這項作業的費用較高，因此每個畫面只應取得一次投影。Google 地圖採用麥卡托投影，先根據地理資料建立地圖，再將地圖上的點轉換為地理座標。

取得地圖的使用者介面設定。

傳回是否要啟用 3D 建築物圖層。

指出目前是否啟用室內地圖。

取得我的位置圖層的狀態。

檢查地圖是否正在繪製交通資料。這取決於可用性資料。

根據更新中所定義的指示調整相機位置。系統會立即移動，而後續的 getCameraPosition() 將反映新位置。如需一系列最新資訊，請參閱 CameraUpdateFactory。

移除所有之前指定的上限和下限。

開啟或關閉 3D 建築物圖層。

設定地圖的 contentDescription。

用於在無障礙模式中提供地圖的語音說明。預設值是「Google 地圖」

設定是否應啟用室內地圖。室內地圖目前一次只能在一張地圖上顯示。根據預設，這是第一張加到您應用程式中的地圖。如要在其他地圖上啟用室內地圖，您必須先停用原始地圖上的室內地圖。如果您在其他地圖啟用室內地圖時嘗試啟用該功能，就不會有任何反應，因而會傳回 false。如果地圖未啟用室內功能，所有與室內相關的方法都會傳回 null 或 false。

為資訊視窗的內容設定自訂轉譯器。

如同地圖的事件監聽器，此狀態不會與地圖序列化。如果重新建立地圖 (例如因為設定變更)，請務必再次呼叫這個方法，才能保留自訂設定。

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

如要完全清除定界框，請將值設為 null。新的邊界會取代所有先前指定的定界框。

當 LatLngBounds 變更時，SDK 會盡可能根據這些邊界調整所有後續相機更新。請注意，基於某些技術性考量，SDK 可能無法將攝影機目標嚴格控制在邊界內。例如浮點精確度捨入錯誤，或縮放等級非常低。

取代我的位置圖層的位置來源。

設定基本地圖的樣式。

您可以使用樣式選項，將自訂樣式套用至地圖上的地圖項目和元素。如要進一步瞭解樣式定義，請參閱 MapStyleOptions。

如果設為 null，則會清除先前的所有自訂樣式。

設定應顯示的地圖圖塊類型。可使用的值如下：

• MAP_TYPE_NORMAL：基本地圖。
• MAP_TYPE_SATELLITE：衛星圖像。
• MAP_TYPE_HYBRID：含有道路和標籤的衛星圖像。
• MAP_TYPE_TERRAIN：地形資料。
• MAP_TYPE_NONE：沒有基本地圖圖塊。

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

當最大縮放等級變更時，SDK 會盡可能按照該上限調整所有後續相機更新。請注意，基於某些技術性考量，SDK 可能無法讓使用者深入放大地圖。舉例來說，衛星地圖或地形圖的最高縮放等級可能低於基本地圖圖塊。

SDK 會解決最小值和最大值的任何衝突。如果您將最小縮放等級設為高於目前上限的縮放等級，SDK 就會使用新的最小和最大縮放等級。如果您將最大縮放等級設為低於最低縮放等級，SDK 就會針對最小和最大值使用新的最大值。例如：假設目前的最小縮放等級是 8，最大值為 14。然後將最大縮放等級設為 6。SDK 至少需要 6 倍和最大縮放等級 6。

設定相機縮放所需的下限。

當最小縮放等級變更時，SDK 會盡可能調整所有之後的相機更新，以採用該最小縮放等級。請注意，基於某些技術性考量，SDK 可能無法讓使用者縮放畫面過低。

SDK 會解決最小值和最大值的任何衝突。如果您將最小縮放等級設為高於目前上限的縮放等級，SDK 就會使用新的最小和最大縮放等級。如果您將最大縮放等級設為低於最低縮放等級，SDK 就會針對最小和最大值使用新的最大值。例如：假設目前的最小縮放等級是 8，最大值為 14。然後將最小縮放等級設為 16。SDK 至少採用 16 倍和最大縮放等級 16。

啟用或停用「我的位置」圖層。

啟用或停用位置資訊後，我的位置圖層會持續繪製指出使用者目前位置和方位的指標，並顯示 UI 控制項，讓使用者與自己的位置互動，例如啟用或停用其位置和方位的攝影機追蹤功能。

如要使用「我的位置」圖層功能，除非您已設定自訂位置來源，否則必須要求 ACCESS_COARSE_LOCATION 或 ACCESS_FINE_LOCATION 的權限。

如果您已透過 setLocationSource(LocationSource) 設定自訂位置來源，Google Maps SDK for Android 不會檢查是否已授予上述權限。然而，您仍須確保使用者已授予自訂位置來源所需的所有權限。

設定相機變更時叫用的回呼。

設定相機動作結束時叫用的回呼。

設定新的回呼類型停止或中斷相機動作時叫用的回呼。

設定相機在移動時重複叫用的回呼。回呼只能以每個影格一次的頻率叫用，而且不應執行昂貴的作業。

設定當相機開始移動或相機動作原因發生變更時叫用的回呼。

設定點選圓形時叫用的回呼。

設定按一下區域疊加層時叫用的回呼。

設定或清除室內事件的監聽器。只能設定一個事件監聽器。設定新的事件監聽器會移除先前的事件監聽器。

設定按一下標記資訊視窗時要叫用的回呼。

設定當標記資訊視窗關閉時，要叫用的回呼。

設定長按標記資訊視窗時要叫用的回呼。

設定使用者輕觸地圖時叫用的回呼。

設定此地圖完成算繪時，所呼叫的回呼。回呼只會叫用一次。

如果在地圖完整算繪後呼叫此方法，系統會立即叫用回呼。如果地圖因連線問題而一直無法載入，或是地圖不斷變更且因使用者持續與地圖互動而從未完成載入，則不會觸發這個事件。

設定長按地圖時叫用的回呼。

設定按一下標記時叫用的回呼。

設定拖曳標記時叫用的回呼。

設定使用者按下我的位置按鈕時叫用的回呼。

如果 listener 傳回 true，系統就會取用該事件，而不會發生預設行為。如果傳回 false，就會發生預設行為 (即攝影機移動，以使用者的位置為中心)。

設定當「我的位置」點變更位置時叫用的回呼。

設定按一下「我的位置」點 (代表使用者位置) 時叫用的回呼。

設定事件監聽器，在點擊或輕觸搜尋點時觸發。

傳遞 null 以清除事件監聽器。

設定按一下多邊形時叫用的回呼。

設定點選折線時叫用的回呼。

設定地圖上的邊框間距。

這個方法可讓您定義地圖上的可見區域，讓地圖在邊緣周圍設定邊框間距，即可指出地圖邊緣的部分可能會遭到遮蔽。地圖函式會根據邊框間距進行調整。舉例來說，縮放控制項、指南針、版權通知和 Google 標誌將移動至定義的區域內，攝影機動作將根據可見區域的中心位置調整。

開啟或關閉車流量圖層。

拍攝地圖快照。

當互動式地圖難以或無法使用時，您可以在應用程式中使用快照。舉例來說，使用 snapshot() 方法產生的圖片可用來在應用程式中顯示地圖縮圖，或在通知中心顯示快照。

注意：地圖圖片不得傳輸至您的伺服器，或在應用程式外用於其他用途。如果您需要將地圖傳送至其他應用程式或使用者，請傳送資料，讓他們為新使用者重新建構地圖 (而非快照)。

拍攝地圖快照。

這個方法相當於 snapshot(SnapshotReadyCallback)，但可讓您提供預先分配的 Bitmap。如果點陣圖與目前的地圖尺寸不符，系統會分配另一個符合地圖尺寸的點陣圖。

雖然在大多數情況下，回呼方法傳遞的物件與此方法中所提供的物件相同，但在某些情況下，傳回的物件可能會不同 (例如，如果檢視畫面的尺寸在快照實際拍攝時變更)。因此，您應該只信任回呼方法傳遞的點陣圖內容。

停止有進行中的相機動畫。呼叫此方法時，相機會立即停止移動，並保持在該位置。