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 的最大縮放等級。

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

啟用定位功能且位置可用時，「我的位置」圖層會持續繪製使用者目前所在位置和航向的位置，並會顯示能讓使用者與其所在位置互動的使用者介面控制項 (例如啟用或停用其位置和方位的相機追蹤)。

如要使用 my-location-layer 功能，除非您已設定自訂位置來源，否則必須要求 ACCESS_COARSE_LOCATION 或 ACCESS_FINE_LOCATION 權限。

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

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

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

設定在新動態動畫停止或中斷相機動作時叫用的回呼。

設定在相機移動時重複叫用的回呼。回呼頻率會依每個頁框一次叫用，而且不應執行昂貴的作業。

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

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

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

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

設定在點選標記資訊視窗時叫用的回呼。

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

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

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

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

如果在地圖完整轉譯時呼叫此方法，系統會立即叫用回呼。如果地圖因連線問題而無法載入，或是地圖持續變更且因為使用者持續與地圖互動而未完成載入，則不會觸發此事件。

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

設定在點選標記時叫用的回呼。

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

設定在「我的位置」按鈕點選時叫用的回呼。

如果 listener 傳回 true，系統就會消耗該事件，而不會產生預設行為。如果傳回 false，就會發生預設行為 (意即相機移動時，會置中於使用者的位置)。

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

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

設定監聽器，在使用者點擊或輕觸搜尋點時觸發。

傳遞 null 即可清除事件監聽器。

設定在點按多邊形時叫用的回呼。

設定使用者點擊折線時叫用的回呼。

設定地圖上的邊框間距。

這個方法可讓您定義地圖上的可見區域，以設定地圖四個邊緣邊緣的邊框間距，以向地圖指出這些邊緣的每個部分都會被遮蓋。地圖功能將調整為邊框間距。舉例來說，縮放控制項、指南針、版權聲明和 Google 標誌都會經過移動，以符合已定義的區域、攝影機的移動位置相對於可見區域的中心等。

開啟或關閉路況圖層。

拍攝地圖快照。

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

注意：地圖圖片不得傳輸到您的伺服器，或是透過應用程式以外的方式使用。如果需要將地圖傳送至其他應用程式或使用者，請傳送資料，讓客戶重新建構地圖 (而非快照)。

拍攝地圖快照。

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

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

停止進行中的動畫動畫。呼叫方法時，相機會立即停止移動，並維持在這個位置。