iOS 版 Maps 3D SDK 快速参考

借助 Maps 3D SDK for iOS,您可以使用 Google 的 3D 图像在 iOS 应用中打造 3D 地图体验。它提供 SwiftUI API,用于标记、弹出式窗口、多段线、多边形、3D 模型 (glTF)、镜头路径动画以及镜头和互动控件。

iOS 版 Maps 3D SDK:关键信息

  • 产品:iOS 版 Maps 3D SDK
  • 类别:Google 地图
  • 平台:iOS
  • 运行位置:客户端(应用或浏览器代码)
  • 发布阶段:GA
  • 生命周期:有效
  • 概览:Maps 3D SDK for iOS 概览

iOS 版 Maps 3D SDK:适用场景

在以下情况下,请使用 iOS 版 Maps 3D SDK:

  • 您需要在原生 iOS (SwiftUI) 应用中添加一个互动式 3D 摄影测量地图。
  • 您需要在 iOS 3D 地图上放置标记、弹出式窗口、多段线、多边形或 glTF 3D 模型。
  • 您需要在 iOS 上的 3D 地图中实现飞入或环绕镜头动画,或镜头限制。
  • 您需要让用户点按 3D 地图上的地图注点,并通过内置的 Places UI Kit widget 查看地点详情。

在以下情况下,请勿使用 iOS 版 Maps 3D SDK:

iOS 版 Maps 3D SDK:设置

官方 iOS 版 Maps 3D SDK 软件包:

  • 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)

iOS 版 Maps 3D SDK:常见错误

  • 问题:如果加载地图时未设置地图模式,地图将无法加载。修复方法:创建 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 中,当用户点按地图注点时,系统会默认显示地点界面 widget。解决方法:使用 placeInformationEnabled(false) 或从 onPlaceTap(_:) 返回 .none 以抑制该 widget。请参阅 /maps/documentation/maps-3d/ios-sdk/points-of-interest。

iOS 版 Maps 3D SDK 的用途

请参阅下面链接的指南,了解每项任务,或在功能探索器中比较不同产品。