Maps 3D SDK for Android 快速參考

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:設定

官方 Maps 3D SDK for Android 套件:

  • maven:com.google.android.gms:play-services-maps3d

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 的用途

請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。