Maps SDK for iOS 快速参考

借助 Maps SDK for iOS,您可以将基于 Google 地图数据的地图添加到 iOS 应用。该 SDK 会处理对 Google 地图服务器的访问、地图显示以及对用户手势的响应,并允许您为地图添加标记、多段线、地面叠加层和信息窗口。

Maps SDK for iOS:关键信息

  • 产品:Maps SDK for iOS
  • 别名:Google Maps SDK for iOS
  • 类别:Google 地图
  • 平台:iOS
  • 运行位置:客户端(应用或浏览器代码)
  • 发布阶段:GA
  • 生命周期:有效
  • 概览:Maps SDK for iOS 概览
  • 适用区域:全球。请参阅 Google Maps Platform 覆盖范围页面;用量和结算页面链接分别提供了全球和印度价格列表。(覆盖范围详情)

Maps SDK for iOS:何时使用

在以下情况下使用 Maps SDK for iOS:

  • 您需要在原生 iOS 应用中添加一个支持手势处理的互动式 Google 地图。
  • 您需要在 iOS 应用中向地图添加标记、多段线、地面叠加层或信息窗口。
  • 您需要在 iOS 应用内显示街景全景图片。
  • 您需要通过一款显示地图的 iOS 应用,将坐标反向地理编码为地址。

在以下情况下,请勿使用 Maps SDK for iOS:

  • 您需要在 iOS 应用中使用 3D 摄影测量地图。请改用 Maps 3D SDK for iOS。
  • 您只需在 Google 地图应用中打开某个地点或路线,而无需在应用中呈现地图。请改用 Maps URL。

Maps SDK for iOS:设置

官方 Maps SDK for iOS 软件包:

  • swift_package: https://github.com/googlemaps/ios-maps-sdk

Maps SDK for iOS:常见错误

  • 问题:SDK 不支持可合并库;在 Xcode 中启用“Build Mergeable Library”(构建可合并库)会导致发布 build 中出现链接器故障。解决方法:将“Build Mergeable Library”(构建可合并库)设置保持为“No”(否,默认值)。请参阅 /maps/documentation/ios-sdk/config。
  • 问题:如果没有 LSApplicationQueriesSchemes 条目,点按地图上的 Google 徽标会记录 comgooglemaps:// 和 googlechromes:// 的 -canOpenURL 失败。解决方法:在 Info.plist 中将 googlechromes 和 comgooglemaps 添加到 LSApplicationQueriesSchemes。请参阅 /maps/documentation/ios-sdk/config。
  • 问题:由于严格的内存限制,在 iOS 应用扩展程序(例如自定义键盘)中使用 SDK 可能会失败。解决方法:在主应用中使用 SDK,而不是在应用扩展程序中使用。请参阅 /maps/documentation/ios-sdk/overview。
  • 问题:SDK 未针对 iPadOS 13 及更高版本的多窗口或同时运行的实例进行优化,可能会出现未定义的行为。解决方法:仔细测试 iPad 多窗口模式场景,或避免同时运行多个地图实例。请参阅 /maps/documentation/ios-sdk/overview。

Maps SDK for iOS:旧版和已弃用的功能

  • OpenGL 渲染程序和 setMetalRendererEnabled:自 2025 年 5 月 19 日起已停用。替代方案:Metal 渲染程序(自 v8.0.0 起默认使用);移除 setMetalRendererEnabled。症状:在 v9.0.0 (2024-05-28) 中已弃用,并在 v10.0.0 中移除;GMSServices 不再列出 setMetalRendererEnabled:。
  • GoogleMapsM4B 模块:自 2025-05-19 起已停用。替代方案:移除 GoogleMapsM4B pod 或框架;它与已废弃的结算方案相关。症状:已于 2024 年 2 月 20 日弃用;已从 v9.0.0 的 Swift 软件包和 v10.0.0 的 SDK 中移除。
  • CocoaPods 分发:自 2026 年 8 月 6 日起弃用。替代方案:Swift Package Manager。症状:自 2025 年 8 月 18 日起进入维护模式;自 11.0.0 版起弃用。请参阅迁移指南。
  • Carthage 安装:自 2022 年 6 月 27 日起已弃用。替代方案:Swift Package Manager。症状:Carthage 不支持面向 iOS 13 及更高版本的库;通过 Carthage 提供的最新版本为 6.2.1。请参阅迁移指南。

Maps SDK for iOS 的用途

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

Maps SDK for iOS:边界的数据驱动型样式

Maps SDK for iOS:数据集的数据驱动型样式

Maps SDK for iOS:数据集

Maps SDK for iOS:地理编码

Maps SDK for iOS:地图

Maps SDK for iOS:地图注释

Maps SDK for iOS:地图样式设置

Maps SDK for iOS:街景