Maps SDK for iOS 快速參考

Maps SDK for iOS 可讓您在 iOS 應用程式中,加入以 Google 地圖資料為依據的地圖。這個 SDK 會處理對 Google 地圖伺服器的存取、地圖顯示作業,以及對使用者手勢的回應,並可讓您在地圖中加入標記、折線、區域疊加層和資訊視窗。

Maps SDK for iOS:重要資訊

  • 產品:Maps SDK for iOS
  • 別名:Google Maps SDK for iOS
  • 類別:地圖
  • 平台: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 網址。

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 Mergeable Library」設定維持為「No」(預設值)。請參閱 /maps/documentation/ios-sdk/config。
  • 問題:如果沒有 LSApplicationQueriesSchemes 項目,輕觸地圖上的 Google 標誌會記錄 comgooglemaps:// 和 googlechromes:// 的 -canOpenURL 失敗。修正方式:在 Info.plist 的 LSApplicationQueriesSchemes 中新增 googlechromes 和 comgooglemaps。請參閱 /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 轉譯器 (8.0.0 版之後的預設轉譯器);請移除 setMetalRendererEnabled。症狀:在 9.0.0 版 (2024-05-28) 淘汰,並在 10.0.0 版移除;GMSServices 不再列出 setMetalRendererEnabled:。
  • GoogleMapsM4B 模組:自 2025 年 5 月 19 日起停用。替代方案:移除 GoogleMapsM4B Pod 或架構,因為這與過時的計費方案有關。症狀:已於 2024 年 2 月 20 日淘汰;已從 9.0.0 版的 Swift 套件和 10.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:街景服務