Maps 3D SDK for Android 可讓 Android 應用程式顯示互動式 3D 地圖,這些地圖是以 Google 的 3D 圖像建構而成。提供標記、彈出式視窗、折線、多邊形、glTF 3D 模型、攝影機路徑動畫,以及使用者互動和攝影機移動控制項。
Maps 3D SDK for Android:重要資訊
- 產品:Maps 3D SDK for Android
- 別名:Maps 3D Android SDK
- 類別:地圖
- 平台:Android
- 執行位置:用戶端 (應用程式或瀏覽器程式碼)
- 推出階段:GA
- 生命週期:有效
- 總覽:Maps 3D SDK for Android 總覽
- 適用地區:有限。適用情形因國家/地區而異,請參閱 Google Maps Platform 涵蓋範圍頁面的「Maps 3D (JavaScript、Android、iOS)」欄。(涵蓋範圍詳細資料)
Maps 3D SDK for Android:使用時機
在下列情況下使用 Maps 3D SDK for Android:
- 您需要在 Android 應用程式中,顯示真實世界地點的互動式擬真 3D 地圖。
- 您需要在 Android 應用程式的 3D 地圖上,放置標記、彈出式視窗、折線、多邊形或 glTF 3D 模型。
- 您需要預先定義的攝影機動畫 (飛到、環繞),引導使用者在 3D 地圖上的各點之間移動。
- 您需要控管使用者在 Android 應用程式的 3D 地圖上,可使用哪些攝影機動作和 UI 控制項。
請勿在下列情況使用 Maps 3D SDK for Android:
- 您正在建構需要 3D 地圖的網頁應用程式。請改用 Maps JavaScript API。
- 您正在建構需要 3D 地圖的 iOS 應用程式。請改用 Maps 3D SDK for iOS。
- 您需要在 Android 應用程式中,使用可部署於正式環境的標準 2D 街道地圖 (這個 SDK 的
ROADMAP模式為實驗功能)。請改用 Maps SDK for Android。
Maps 3D SDK for Android:設定
- 要啟用的服務:
mapsandroid.googleapis.com - 驗證:API 金鑰
- 開始使用:設定 Maps 3D SDK for Android
- 參考資料:Maps 3D SDK for Android 參考資料
- 定價:Maps 3D SDK for Android 用量與計費方式
- 政策:Maps 3D SDK for Android 政策
- 版本資訊:Maps 3D SDK for Android 版本資訊
官方 Maps 3D SDK for Android 套件:
- maven:
com.google.android.gms:play-services-maps3d
Maps 3D SDK for Android:相關產品
- 常搭配使用:Places SDK for Android
Maps 3D SDK for Android:常見錯誤
- 問題:如果載入地圖時未指定地圖模式,地圖就無法載入。修正方式:請一律在版面配置 XML (
map3d:mapMode) 中,或使用setMapMode/Map3DInitConfig設定Map3DMode(SATELLITE、HYBRID或ROADMAP)。請參閱 /maps/documentation/maps-3d/android-sdk/map-modes。 - 問題:點擊事件監聽器 (地圖和標記點擊) 不會在主要 UI 執行緒上執行,因此無法直接從處理常式更新 UI。修正方式:更新 UI 前,請先切換至主執行緒,例如使用
lifecycleScope.launch(Dispatchers.Main)。請參閱 /maps/documentation/maps-3d/android-sdk/add-a-marker。 - 問題:地圖狀態會在
Map3DView執行個體之間共用,因此舊檢視畫面的標記、疊加層和攝影機位置會沿用至新檢視畫面。修正方式:只保留一個有效的Map3DView;在舊執行個體上呼叫onDestroy(),並手動清除標記、疊加層,然後透過GoogleMap3D重設攝影機。請參閱 /maps/documentation/maps-3d/android-sdk/add-a-3d-map。 - 問題:根據預設,輕觸基本地圖搜尋點會顯示 Places UI 小工具,這也需要 Places SDK 依附元件。修正方式:新增 Places SDK for Android 依附元件,並從
OnMap3DClickListener的onMap3DClick傳回true,即可隱藏預設小工具。請參閱 /maps/documentation/maps-3d/android-sdk/points-of-interest。
Maps 3D SDK for Android 的用途
請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。
- 在網頁中加入互動式擬真 3D 地圖。
- 在擬真 3D 地圖上新增標記。
- 自訂擬真 3D 地圖上的標記。
- 在擬真 3D 地圖中加入 3D 模型。
- 在擬真 3D 地圖中加入 3D 折線。
- 在擬真 3D 地圖中加入 3D 多邊形。
- 在擬真 3D 地圖上回應使用者互動和事件。
- 自訂擬真 3D 地圖上顯示的控制項。
- 在擬真 3D 地圖上控制相機路徑和動畫。
- 控管擬真 3D 地圖的攝影機限制。