借助 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:
- 您需要在 Android 应用中使用 3D 地图。请改用 Maps 3D SDK for Android。
- 您需要在网页中添加 3D 地图。请改用 Maps JavaScript API。
- 您需要在 iOS 应用中添加标准 2D 地图。请改用 Maps SDK for iOS。
iOS 版 Maps 3D SDK:设置
- 要启用的服务:
mapsios.googleapis.com - 身份验证:API 密钥
- 开始使用:设置 iOS 版 Maps 3D SDK
- 参考文档:Maps 3D SDK for iOS 参考文档
- 价格:Maps 3D SDK for iOS 的用量和结算
- 政策:Maps 3D SDK for iOS 政策
- 版本说明: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:相关产品
- 通常与以下产品搭配使用:Places SDK for iOS
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。 - 问题:
CameraaltitudeMode在相机动画之外会被忽略;它仅适用于flyCameraTo和flyCameraAround。修复方法:如果您依赖于CameraaltitudeMode,请使用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 的用途
请参阅下面链接的指南,了解每项任务,或在功能探索器中比较不同产品。
- 向网页添加互动式 3D 摄影实景地图。
- 向 3D 摄影测量地图添加标记。
- 在 3D 摄影测量地图上自定义标记。
- 向 3D 摄影级地图添加 3D 模型。
- 向 3D 摄影测量地图添加 3D 多段线。
- 向 3D 摄影测量地图添加 3D 多边形。
- 在 3D 摄影测量地图上响应用户互动和事件。
- 自定义 3D 摄影测量地图上显示的控件。
- 在 3D 摄影地图上控制镜头路径和动画。
- 在 3D 摄影测量地图上控制相机限制。