Maps 3D SDK for iOS 快速參考

Maps 3D SDK for iOS 可讓您使用 Google 的 3D 圖像,在 iOS 應用程式中打造 3D 地圖體驗。提供標記、彈出式視窗、折線、多邊形、3D 模型 (glTF)、攝影機路徑動畫,以及攝影機和互動控制項的 SwiftUI API。

Maps 3D SDK for iOS:重要資訊

  • 產品:Maps 3D SDK for iOS
  • 類別:地圖
  • 平台:iOS
  • 執行位置:用戶端 (應用程式或瀏覽器程式碼)
  • 推出階段:GA
  • 生命週期:有效
  • 總覽:Maps 3D SDK for iOS 總覽

Maps 3D SDK for iOS:使用時機

在下列情況下使用 Maps 3D SDK for iOS:

  • 您需要在原生 iOS (SwiftUI) 應用程式中,加入互動式擬真 3D 地圖。
  • 您需要在 iOS 3D 地圖上放置標記、彈出式視窗、折線、多邊形或 glTF 3D 模型。
  • 您需要在 iOS 的 3D 地圖上,加入飛往或環繞攝影機動畫,或設定攝影機限制。
  • 您需要讓使用者輕觸 3D 地圖點,並透過內建的 Places UI Kit 小工具查看 Place Details。

請勿在下列情況使用 Maps 3D SDK for iOS:

Maps 3D SDK for iOS:設定

官方 Maps 3D SDK for iOS 套件:

  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3D)
  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3DKit, for POI taps with the Places UI Kit widget)

Maps 3D SDK for iOS:常見錯誤

  • 問題:如果地圖載入時未設定地圖模式,地圖就無法載入。修正方式:建立 Map 時,一律要傳遞模式,例如 Map(mode: .hybrid)。請參閱 /maps/documentation/maps-3d/ios-sdk/map-modes。
  • 問題:同時在應用程式進入點和個別地圖檢視中設定 API 金鑰,會產生控制台錯誤。修正方式:請只在一個位置設定 Map.apiKey,也就是應用程式進入點或每個地圖檢視。請參閱 /maps/documentation/maps-3d/ios-sdk/setup。
  • 問題:Camera altitudeMode 在攝影機動畫以外會遭到忽略,僅適用於 flyCameraTo 和 flyCameraAround。修正方式:如果依附於 Camera altitudeMode,請使用 flyCameraTo 或 flyCameraAround。請參閱 /maps/documentation/maps-3d/ios-sdk/custom-camera-paths。
  • 問題:在 GoogleMaps3DKit 中,當使用者輕觸搜尋點時,系統預設會顯示 Places UI 小工具。修正方式:使用 placeInformationEnabled(false) 或從 onPlaceTap(_:) 傳回 .none,即可隱藏小工具。請參閱 /maps/documentation/maps-3d/ios-sdk/points-of-interest。

Maps 3D SDK for iOS 的用途

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