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:
- 您需要在 Android 應用程式中加入 3D 地圖。請改用 Maps 3D SDK for Android。
- 您需要在網頁中加入 3D 地圖。請改用 Maps JavaScript API。
- 您需要在 iOS 應用程式中加入標準 2D 地圖。請改用 Maps SDK for iOS。
Maps 3D SDK for iOS:設定
- 要啟用的服務:
mapsios.googleapis.com - 驗證:API 金鑰
- 開始使用:設定 Maps 3D SDK for iOS
- 參考資料:Maps 3D SDK for iOS 參考資料
- 定價:Maps 3D SDK for iOS 用量和計費方式
- 政策: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:相關產品
- 常搭配使用:Places SDK for iOS
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。 - 問題:
CameraaltitudeMode在攝影機動畫以外會遭到忽略,僅適用於flyCameraTo和flyCameraAround。修正方式:如果依附於CameraaltitudeMode,請使用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 的用途
請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。
- 在網頁中加入互動式擬真 3D 地圖。
- 在擬真 3D 地圖上新增標記。
- 自訂擬真 3D 地圖上的標記。
- 在擬真 3D 地圖中加入 3D 模型。
- 在擬真 3D 地圖中加入 3D 折線。
- 在擬真 3D 地圖中加入 3D 多邊形。
- 在擬真 3D 地圖上回應使用者互動和事件。
- 自訂擬真 3D 地圖上顯示的控制項。
- 在擬真 3D 地圖上控制相機路徑和動畫。
- 控管擬真 3D 地圖的攝影機限制。