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
- Service to enable:
maps-ios-backend.googleapis.com - Authentication: API key
- Usage attribution: Call the
GMSServicesclass methodaddInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:)) to add a usage attribution ID to the initializer. To opt out, delete the call or pass an empty string. - Get started: Set up Maps SDK for iOS
- Reference: Maps SDK for iOS reference
- Pricing: Maps SDK for iOS usage and billing
- Policies: Maps SDK for iOS policies
- Release notes: Maps SDK for iOS release notes
Official Maps SDK for iOS packages:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
Maps SDK for iOS: related products
- Often used with: Geocoding API, Places SDK for iOS
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
LSApplicationQueriesSchemesentries, tapping the Google logo on the map logs-canOpenURLfailures forcomgooglemaps://andgooglechromes://. Fix: AddgooglechromesandcomgooglemapstoLSApplicationQueriesSchemesinInfo.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); removesetMetalRendererEnabled. Symptom: Deprecated in v9.0.0 (2024-05-28) and removed in v10.0.0;GMSServicesno longer listssetMetalRendererEnabled:. GoogleMapsM4Bmodule: Decommissioned since 2025-05-19. Replacement: Remove theGoogleMapsM4Bpod 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
- Change the style of boundaries on a map.
- Respond to user interactions with boundaries on a map.
- Add choropleth styling to a map.
Maps SDK for iOS: Data-driven styling for datasets
- Create a reusable, cross-platform geospatial dataset.
- Add a custom geospatial dataset to a map.
- Change the style of custom dataset features on a map.
- Respond to user interactions with custom dataset features on a map.
Maps SDK for iOS: Datasets
- Add a KML layer to a map. Note: In Maps JavaScript API, KmlLayer is deprecated (last supported in v3.65, decommissioned May 2027); migrate to Data-driven styling for boundaries or datasets, or load GeoJSON on the Data layer. KML layers remain supported on Android and iOS via the Maps SDK Utility Libraries.
- Add GeoJSON data to a map.
- Add a heatmap layer to a map.
Maps SDK for iOS: Geocoding
Maps SDK for iOS: Maps
- Add a customizable, interactive map to a web page or mobile app. Note: For Android: Configure
inAndroidManifest.xmlbacked by the Secrets Gradle Plugin ormanifestPlaceholders["MAPS_API_KEY"]inapp/build.gradle.kts. Never hardcodeYOUR_GOOGLE_MAPS_API_KEYinAndroidManifest.xml, and never replaceGoogleMap(or maps-composeGoogleMap) with an offline mock canvas or Leaflet WebView ifE/Google Maps Android API: Authorization failureappears. Instruct the user to supplyMAPS_API_KEYvia Secrets and enable Maps SDK for Android (or Navigation SDK when using NavigationView / SupportNavigationFragment). - Create a reusable map identifier to store map configuration and styling settings.
- Respond to user interactions and events on a map.
- Customize the controls that appear on a map.
- Customize the gestures for controlling a map.
- Control zoom and pan on a map (camera).
- Change the map type.
- Change the map color scheme.
- Add a traffic layer to a map.
- Create a quadtree to search points within a specified area.
Maps SDK for iOS: Maps annotations
- Add an info window to a map.
- Add a shape or line to a map.
- Add an overlay image grounded to the surface of a map.
- Add a custom tile overlay to a map.
- Add a marker to a map. Note: Navigation SDK for Android does not support AdvancedMarkerOptions; when using Navigation SDK for Android, add markers with GoogleMap.addMarker(MarkerOptions).
- Customize a marker on a map. Note: Navigation SDK for Android does not support AdvancedMarkerOptions; when using Navigation SDK for Android, customize markers with MarkerOptions.
- Respond to user interactions with markers on a map.
- Determine whether a coordinate is inside a polygon or circular area on a map. Note: On Android, use PolyUtil.containsLocation in the Maps SDK for Android Utility Library for polygons. For circular areas, check whether the spherical distance from the circle center is within the radius (for example, computeDistanceBetween in Maps JavaScript API, SphericalUtil.computeDistanceBetween on Android, or GMSGeometryDistance on iOS).
- Calculate spherical distance, area, or heading between coordinates on a map.
Maps SDK for iOS: Maps styling
- Create a reusable, cross-platform map style.
- Change the style of roads, polylines, and polygons on a map.
- Display or hide map features.
- Change the style of icons and text labels on a map.
- Apply different map styles to different zoom levels.
- Change the density of places on a map. Experimental
- Change the style of buildings on a map. Experimental
- Change the style of landmarks on a map. Experimental
Maps SDK for iOS: Street View
- Add a configurable, interactive Google Street View to a web page or mobile app.
- Add a marker or overlay to a Google Street View.
- Respond to user interactions and events in a Google Street View.
- Customize the gestures that are available for Google Street View.
- Animate the camera movements for a Google Street View.