Maps SDK for iOS quick reference

The Maps SDK for iOS lets you add maps based on Google Maps data to iOS apps. The SDK handles access to the Google Maps servers, map display, and response to user gestures, and lets you add markers, polylines, ground overlays, and info windows to the map.

Maps SDK for iOS: key facts

  • Product: Maps SDK for iOS
  • Also known as: Google Maps SDK for iOS
  • Category: Maps
  • Platform: iOS
  • Runs on: Client (app or browser code)
  • Launch stage: GA
  • Lifecycle: Active
  • Overview: Maps SDK for iOS overview
  • Regional availability: Global. See the Google Maps Platform coverage page; the usage and billing page links separate global and India pricing lists. (coverage details)

Maps SDK for iOS: when to use it

Use Maps SDK for iOS when:

  • You need an interactive Google map with gesture handling inside a native iOS app.
  • You need to add markers, polylines, ground overlays, or info windows to a map in an iOS app.
  • You need to show Street View panoramas inside an iOS app.
  • You need to reverse geocode coordinates into addresses from an iOS app that shows a map.

Don't use Maps SDK for iOS when:

  • You need photorealistic 3D maps in an iOS app. Use Maps 3D SDK for iOS instead.
  • You only need to open a location or directions in the Google Maps app instead of rendering a map in your app. Use Maps URLs instead.

Maps SDK for iOS: setup

Official Maps SDK for iOS packages:

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

Maps SDK for iOS: common mistakes

  • Problem: The SDK doesn't support Mergeable Libraries; enabling Build Mergeable Library in Xcode causes linker failures in release builds. Fix: Keep the Build Mergeable Library setting set to No (the default). See /maps/documentation/ios-sdk/config.
  • Problem: Without LSApplicationQueriesSchemes entries, tapping the Google logo on the map logs -canOpenURL failures for comgooglemaps:// and googlechromes://. Fix: Add googlechromes and comgooglemaps to LSApplicationQueriesSchemes in Info.plist. See /maps/documentation/ios-sdk/config.
  • Problem: Using the SDK inside iOS app extensions (for example, a custom keyboard) is unlikely to work because of strict memory restrictions. Fix: Use the SDK in the main app, not in app extensions. See /maps/documentation/ios-sdk/overview.
  • Problem: The SDK isn't optimized for iPadOS 13+ multiple windows or simultaneous instances and may show undefined behavior. Fix: Test multi-window iPad scenarios carefully or avoid multiple simultaneous map instances. See /maps/documentation/ios-sdk/overview.

Maps SDK for iOS: legacy and deprecated features

  • OpenGL renderer and setMetalRendererEnabled: Decommissioned since 2025-05-19. Replacement: Metal renderer (default since v8.0.0); remove setMetalRendererEnabled. Symptom: Deprecated in v9.0.0 (2024-05-28) and removed in v10.0.0; GMSServices no longer lists setMetalRendererEnabled:.
  • GoogleMapsM4B module: Decommissioned since 2025-05-19. Replacement: Remove the GoogleMapsM4B pod or framework; it relates to an obsolete billing plan. Symptom: Deprecated 2024-02-20; removed from the Swift package in v9.0.0 and from the SDK in v10.0.0.
  • CocoaPods distribution: Deprecated since 2026-08-06. Replacement: Swift Package Manager. Symptom: Maintenance mode since 2025-08-18; deprecated as of version 11.0.0. See the migration guide.
  • Carthage installation: Deprecated since 2022-06-27. Replacement: Swift Package Manager. Symptom: Carthage doesn't support libraries targeting iOS 13+; latest version available through Carthage is 6.2.1. See the migration guide.

What you can do with Maps SDK for iOS

See the guides linked below for each task, or compare across products in the Capabilities Explorer.

Maps SDK for iOS: Data-driven styling for boundaries

Maps SDK for iOS: Data-driven styling for datasets

Maps SDK for iOS: Datasets

Maps SDK for iOS: Geocoding

Maps SDK for iOS: Maps

Maps SDK for iOS: Maps annotations

Maps SDK for iOS: Maps styling

Maps SDK for iOS: Street View