控制項和手勢| Maps SDK for Android

Maps API 提供內建的UI 控制項，與Android 手機中Google 地圖應用程式的控制項類似。

... 使用者將兩根手指放在地圖上，同時向上移動可增加地圖的傾斜角度；向下移動則 ... Google 地圖平台 總覽 產品 定價 說明文件 開始使用 開始使用Google地圖平台 API挑選器 計費和定價方式 報表與監控 地圖ID 常見問題 支援與資源 事件管理 地圖介面集 MapsJavaScriptAPI MapsSDKforAndroid MapsSDKforiOS MapsStaticAPI StreetViewStaticAPI MapsEmbedAPI 地圖網址 MapsElevationAPI 路徑介面集 DirectionsAPI DistanceMatrixAPI RoadsAPI 解決方案 產業解決方案 遊戲服務 運輸與物流 地點介面集 PlacesAPI PlacesSDKforAndroid PlacesSDKforiOS PlacesLibrary、MapsJavaScriptAPI GeocodingAPI GeolocationAPI TimeZoneAPI 其他資源 API安全性最佳做法 地圖涵蓋範圍詳細資料 最佳化指南 行動作業系統和軟體支援 淘汰項目 資產追蹤方案 根憑證授權單位遷移常見問題 網址編碼 WordPress使用者 網誌 社群 StackOverflow GitHub YouTube Discord Twitter IssueTracker Language English BahasaIndonesia Deutsch Español Español–AméricaLatina Français Português–Brasil Русский 中文–简体 中文–繁體 日本語 한국어 登入 Android MapsSDKforAndroid 開始使用 聯絡銷售人員 指南 參考資料 範例 支援 Google 地圖平台 總覽 產品 定價 說明文件 More 指南 參考資料 範例 支援 網誌 社群 More MapsSDKforAndroid 總覽 快速入門導覽課程 設定 設定GoogleCloud專案 使用API金鑰 設定AndroidStudio專案 版本 Beta版 MapsSDKforAndroid3.1.0Beta版 使用MapsSDK3.1.0Beta版Beta版 教學課程 含有標記的地圖 代表路徑和區域的折線和多邊形 選取目前所在地點 作業與概念 建立和設定地圖 新增地圖設定現有地圖新版地圖轉譯器(選用)街景服務全景商家和其他搜尋點精簡模式 與地圖互動 相機和檢視畫面控制項和手勢事件位置資料啟動Google地圖 在地圖上繪圖 標記資訊視窗形狀區域疊加層圖塊疊加層 管理標記和標籤衝突 使用雲端式地圖樣式設定進行自訂 使用JSON樣式進行自訂 新增樣式化地圖使用樣式隱藏地圖項目樣式參考資料 強化無障礙功能 在WearOS上使用MapsAPI 程式庫與擴充功能 公用程式庫 總覽設定和示範GeoJSONKML熱視圖標記叢集多圖層 KTXKotlin擴充功能 總覽與設定 MapsCompose程式庫 總覽與設定 條款與政策 用量與計費 回報與監控 服務條款 為GooglePlay的資料揭露規定做好準備 開始使用 開始使用Google地圖平台 API挑選器 計費和定價方式 報表與監控 地圖ID 常見問題 支援與資源 事件管理 地圖介面集 MapsJavaScriptAPI MapsSDKforAndroid MapsSDKforiOS MapsStaticAPI StreetViewStaticAPI MapsEmbedAPI 地圖網址 MapsElevationAPI 路徑介面集 DirectionsAPI DistanceMatrixAPI RoadsAPI 解決方案 產業解決方案 遊戲服務 運輸與物流 地點介面集 PlacesAPI PlacesSDKforAndroid PlacesSDKforiOS PlacesLibrary、MapsJavaScriptAPI GeocodingAPI GeolocationAPI TimeZoneAPI 其他資源 API安全性最佳做法 地圖涵蓋範圍詳細資料 最佳化指南 行動作業系統和軟體支援 淘汰項目 資產追蹤方案 根憑證授權單位遷移常見問題 網址編碼 WordPress使用者 StackOverflow GitHub YouTube Discord Twitter IssueTracker 首頁 產品 Google地圖平台 說明文件 Android MapsSDKforAndroid 指南 提供意見 控制項和手勢 選取平台： Android iOS JavaScript 您可使用MapsSDKforAndroid來決定要在地圖上顯示哪些內建UI元件，以及允許哪些手勢，藉此自訂使用者與地圖的互動方式。

程式碼範例 GitHub上的ApiDemos存放區有各種控制項和手勢選項的使用說明範例： UiSettingsDemoActivity：Java範例 UiSettingsDemoActivity：Kotlin範例 減少使用者互動的精簡模式 如果您希望地圖簡單易用且盡可能減少使用者互動，建議使用精簡模式地圖。

精簡模式會以指定的位置和縮放等級提供地圖的點陣圖圖片。

在精簡模式中，使用者無法平移或縮放地圖，也無法使用手勢。

詳情請參閱精簡模式指南。

UI控制項 MapsAPI提供內建的UI控制項，與Android手機中Google地圖應用程式的控制項類似。

您可以透過GoogleMap.getUiSettings方法從GoogleMap取得UiSettings類別，並使用這個類別切換這些控制項的顯示設定。

以這個類別進行的變更會立即反映在地圖上。

如要查看這些功能的範例，請參閱範例應用程式中的UI設定示範活動。

當您透過XML屬性或使用GoogleMapOptions類別建立地圖時，也可以設定其中的大部分選項。

詳情請參閱設定初始狀態。

每個UI控制項都有一個相對於地圖邊緣的預先定義位置。

只要將邊框間距加入GoogleMap物件，即可讓控制項與頂端、底部、左側或右側邊緣拉開距離。

縮放控制項 MapsAPI提供的內建縮放控制項顯示在地圖右下角；這些控制項預設為停用，呼叫UiSettings.setZoomControlsEnabled(true)即可啟用。

指南針 在某些情況下，MapsAPI會提供指南針圖形(顯示在地圖左上角)。

只有在攝影機朝向非零航向或非零傾斜時，指南針才會顯示。

使用者按一下指南針後，攝影機會移動回航向和傾斜角度皆為零的位置(預設方向)，指南針隨後也會消失。

您可以呼叫UiSettings.setCompassEnabled(boolean)來停用隨動作一併顯示的指南針， 但無法強制指南針永遠顯示。

我的位置按鈕 「我的位置」按鈕「只有」在「我的位置」圖層已啟用時，才會顯示在畫面右上角。

詳情請參閱位置資料指南。

層面挑選器 根據預設，使用者正在瀏覽室內地圖時，螢幕中央右側邊緣附近會顯示層面挑選器(樓層挑選器)。

系統顯示兩張以上的室內地圖時，系統會將層面挑選器套用至目前位於焦點內的建築物(通常是距離螢幕中央最近的建築物)。

每個建築物都有預設層面，系統會在首次顯示挑選器時選取這個層面，使用者也可以從挑選器中選取其他層面。

您可以呼叫GoogleMap.getUiSettings().setIndoorLevelPickerEnabled(boolean)來停用或啟用層面挑選器控制項。

如果您想用自己的層面挑選器取代預設的版本，這個方法就十分實用。

地圖工具列 根據預設，使用者輕觸標記時，地圖的右下角會顯示工具列。

工具列可讓使用者快速存取Google地圖行動應用程式。

您可以呼叫UiSettings.setMapToolbarEnabled(boolean)來啟用及停用工具列。

在精簡模式地圖中，不管使用者做了什麼動作，工具列都會持續顯示。

在完整互動式的地圖中，使用者輕觸標記時，工具列會滑入畫面；標記不在焦點內時，工具列就會再次滑出。

工具列會顯示圖示，方便您在Google地圖行動應用程式中查看地圖檢視或要求規劃路線。

使用者輕觸工具列上的圖示時，API便會建立可在Google地圖行動應用程式中啟動對應活動的意圖。

工具列顯示於地圖右下角(請見上方螢幕截圖)。

視地圖內容而定，只要Google地圖行動應用程式支援產生的意圖，地圖上就會顯示「零」或「一」的意圖圖示，或兩個同時顯示。

注意事項：為因應Android11的套件瀏覽權限隱私權異動，如果您的應用程式指定30以上的API級別，請將Google地圖套件「com.google.android.apps.maps」新增為AndroidManifest.xml元素中的項目。

地圖手勢 凡是使用MapsSDKforAndroid建立的地圖，支援的手勢都與Google地圖應用程式支援的相同。

不過在某情況下，為了維持地圖當下的狀態，您可能會想要停用某些手勢。

您也可以透過程式輔助設定縮放、平移、傾斜和航向；詳情請參閱攝影機和檢視畫面。

請注意，停用手勢並不影響是否能透過程式輔助方式改變相機位置。

和UI控制項一樣，您可以呼叫GoogleMap.getUiSettings從GoogleMap取得UiSettings類別，再使用此類別啟用/停用手勢。

以這個類別進行的變更會立即反映在地圖上。

如要查看這些功能的範例，請參閱範例應用程式中的UI設定示範活動(安裝方式請參閱這裡)。

當您透過XML屬性或使用GoogleMapOptions類別建立地圖時，也可以設定這些選項。

詳情請參閱設定地圖。

縮放手勢 地圖會回應可改變攝影機縮放等級的各種手勢： 輕觸兩下可使縮放等級增加1級(放大)。

雙指輕觸可使縮放等級減少1級(縮小)。

雙指撥動/延伸 單指輕觸兩下，第二下不放開，同時向上滑動手指可縮小，向下滑動則可放大。

您可以呼叫UiSettings.setZoomGesturesEnabled(boolean)來停用縮放手勢，這並不影響使用者是否能使用縮放控制項來放大和縮小。

捲動(平移)手勢 使用者用手指拖曳地圖，即可捲動(平移)地圖。

您可以呼叫UiSettings.setScrollGesturesEnabled(boolean)來停用捲動功能。

傾斜手勢 使用者將兩根手指放在地圖上，同時向上移動可增加地圖的傾斜角度；向下移動則會縮小傾斜角度。

您可以呼叫UiSettings.setTiltGesturesEnabled(boolean)來停用傾斜手勢。

旋轉手勢 使用者將兩根手指放在地圖上做出旋轉動作，即可旋轉地圖。

您可以呼叫UiSettings.setRotateGesturesEnabled(boolean)來停用旋轉功能。

提供意見 Exceptasotherwisenoted,thecontentofthispageislicensedundertheCreativeCommonsAttribution4.0License,andcodesamplesarelicensedundertheApache2.0License.Fordetails,seetheGoogleDevelopersSitePolicies.JavaisaregisteredtrademarkofOracleand/oritsaffiliates. Lastupdated2022-03-30UTC. [{ "type":"thumb-down", "id":"missingTheInformationINeed", "label":"缺少我需要的資訊" },{ "type":"thumb-down", "id":"tooComplicatedTooManySteps", "label":"過於複雜/步驟過多" },{ "type":"thumb-down", "id":"outOfDate", "label":"過時" },{ "type":"thumb-down", "id":"translationIssue", "label":"翻譯問題" },{ "type":"thumb-down", "id":"samplesCodeIssue", "label":"示例/程式碼問題" },{ "type":"thumb-down", "id":"otherDown", "label":"其他" }] [{ "type":"thumb-up", "id":"easyToUnderstand", "label":"容易理解" },{ "type":"thumb-up", "id":"solvedMyProblem", "label":"確實解決了我的問題" },{ "type":"thumb-up", "id":"otherUp", "label":"其他" }] 想進一步說明嗎？ StackOverflow 使用google-maps標記提出問題。

GitHub 運用現有樣本進行設計。

Discord 與其他開發人員交流，瞭解Google地圖平台。

IssueTracker 如果發生錯誤，請傳送錯誤報告給我們！ 瞭解詳情 常見問題 API挑選器 PlacesSDKforAndroid 平台 Android iOS 網路 網路服務 產品資訊 計費方式與方案簡介 與銷售人員聯絡 支援 服務條款 Android Chrome Firebase GoogleCloudPlatform 所有產品 條款 隱私權 訂閱GoogleDevelopers電子報 訂閱 Language English BahasaIndonesia Deutsch Español Español–AméricaLatina Français Português–Brasil Русский 中文–简体 中文–繁體 日本語 한국어