Subscribe to these release notes.This page is updated with each new release of the Maps SDK for iOS. The changelog lists releases by date and includes any new features, bug fixes and significant performance improvements.
Consult the Getting Started documentation for information on how to download the most recent version of the Maps SDK for Android.
August 15, 2022
Freezing support for iOS 13 - August 15, 2022
According to the Mobile OS version support policy, we are freezing support for iOS 13 in an upcoming major version of Maps and Places SDKs for iOS.
Versions of Maps and Places SDKs for iOS that release beginning the second quarter of 2023 will support a minimum of iOS 14. Earlier SDK versions will continue supporting iOS 13.
If your dependencies do not specify a version number, your IDE will load the newest SDK version and new builds of your app will not support iOS 13.
Be sure to specify a version in your application's build dependencies in order to control when you raise the minimum supported OS for new versions of your app.
With this release of the Maps SDK for iOS, we have moved the XML feed to a new location. Subscribe to the new location of the XML feed at:
Version 7.0 - June 27, 2022
Support for iOS 12 is now frozen. The minimum iOS version is now 13.0.
The new minimum version of Xcode is 13.0.
Version 6.2.1 - May 9, 2022
Fix an issue where apps running in the iOS simulator would crash when using the Metal renderer (Issue 208593323).
Fix crash that occurred occasionally when a GMSMapView instance was released.
Version 6.2.0 - April 25, 2022
Cloud-based maps styling lets you style, customize, and manage your maps using the Google Cloud Console. Cloud-based maps styling is a paid feature accessed by adding a map ID to your app. The map ID triggers a map load charged against the Dynamic Maps SKU for Maps SDK for iOS.
In previous releases of the Maps SDK for iOS, if you exceeded your usage quota for the map ID, your app displayed an error message to the user. With this release, if you exceed your usage quota, Cloud-based maps styling is disabled and your map appears without any custom styling. Error messages are no longer displayed to the user.
Version 6.1.1 - March 22, 2022
Fixed an issue where labels disappeared at certain zoom levels when using a custom style.
Fixed an issue where a deadlock could occur when using the Metal renderer.
Version 6.1.0 - March 9, 2022
- Version bump with no feature changes. Added stability improvements and bug fixes to the release.
Versions 2.5 and lower deprecation - January 26, 2022
Maps SDK for iOS v2.5 and lower are now deprecated and will be fully decommissioned in January 2023.
Application versions built with Maps SDK for iOS v2.5 and lower will no longer work after those versions are decommissioned. To avoid disruption for your users, build new versions of your application with Maps SDK for iOS v2.6 or higher and encourage users to upgrade to the newer versions of your app before January 2023.
Note that v2.6 supports a minimum of iOS 8, which will be the new minimum OS supported by Maps SDK for iOS, so users may need to upgrade their version of iOS as well.
Version 2.6 also supports a minimum of Xcode 8.0, so this deprecation also raises the minimum IDE supported by Maps SDK for iOS.
Be sure to specify a version in your application's build dependencies in order to control which version of the SDK you build with, which has implications on minimum OS supported for your users. See the guidance on app maintenance best practices which encourages specifying the newest version available in order to access the latest features and bugfixes.
Version 6.0.1 - December 9, 2021
- Added stability improvements to the release.
Version 6.0.0 - November 29, 2021
appearAnimationfield on GMSMarker can now be set to
kGMSMarkerAnimationFadeInto cause the marker to fade in when added.
(Beta) This release contains a preview of support for the XCFramework format. You can now install the Maps SDK for iOS as an XCFramework, a binary package that you can use on multiple platforms including machines using the M1 chipset.
Google recommends that you only use this Beta release for development and testing, and rely on the
.frameworkversion of the SDK for your production apps.
- Fixed an issue where custom tile images with alpha transparency were not being rendered properly by GMSTileLayer.
Support for iOS 11 is now frozen. The minimum iOS version is now 12.0.
The new minimum version of Xcode is 12.0.
Support for Cloud-based maps styling (paid feature) - October 27, 2021
Version 5.2.0 - October 19, 2021
Opt-in support added for using the Metal rendering framework from Apple. To try the Metal renderer in your app, call
[GMSServices setMetalRendererEnabled:YES]in Objective-C, or
GMSServices.setMetalRendererEnabled(true)in Swift before creating any map views.
If you are Installing the SDK manually, you must also ensure to add the
Polylines can now have a repeated image, or stamp, over the line. See the GMSPolyline Class reference for more information.
- Fixed an issue in the OpenGL renderer where marker images were drawn slightly smaller than intended.
Texture stamp images can appear distorted on polylines when using the OpenGL renderer (Issue 200024432).
Polylines with segments that meet at an acute angle may appear differently on the OpenGL or Metal renderers (Issue 200025456).
Freezing support for iOS 12 - October 18, 2021
In response to changes in our internal dependencies, we are freezing support for iOS 12 in an upcoming major version of Maps SDK for iOS.
Versions of Maps SDK for iOS released beginning the second quarter of 2022 will support a minimum of iOS 13. Earlier SDK versions will continue supporting iOS 12.
If your dependencies in CocoaPods or Carthage do not specify a version number, Xcode will load the newest version and new builds of your app will not support iOS 12.
Be sure to specify a version in your application's build dependencies in order to control when you raise the minimum supported OS for new versions of your app. See the guidance on app maintenance best practices.
Beta SDK deprecation - August 18, 2021
The Beta versions of Maps SDK for Android and iOS are now deprecated and will be fully decommissioned in late 2022. A supported version of the Maps SDK for Android and iOS will be made available at least one year prior to the beta SDK being fully decommissioned, which is estimated to occur in late 2022.
The use of the mobile Maps SDKs (Android & iOS) Beta will be degraded per the following schedule:
- As of the date of this release note, the Maps SDK for Android Beta (versions 3.0.0 and 3.1.0) client library is deprecated.
- All features of the Beta SDK will be supported in upcoming releases of the Maps SDK for Android distributed as part of the Google Play services SDK.
- Support for the Maps SDK for Android Beta (versions 3.0.0 to and 3.1.0) will cease no earlier than November 2022.
- As the date of this release note, the Maps SDK for iOS Beta (versions v3.0.0 and v3.10.0) is deprecated.
- All features of the Beta SDK will be supported in upcoming releases of the Maps SDK for iOS distributed via CocoaPods and Carthage.
- Support for the Maps SDK for iOS Beta (versions v3.0.0 and v3.10.0) will cease no earlier than November 2022.
On all platforms, the Beta SDKs will be fully decommissioned, at least one year after a supported (non-Beta) version is released. We will communicate with you again once the new version is released, so that you can start your migration efforts.
What do you need to do?
If you are not currently using features in Beta (maps customization, marker collision handling, or polyline customization—Android, iOS), please update your apps to use a supported version as soon as possible before the decommission in late 2022. See the Android and iOS documentation for instructions.
If you are currently using features in Beta, you should wait for upcoming releases of the SDKs to migrate to a supported SDK version.
Contact Google Maps Platform Support with any questions.
Freezing support for iOS 11 - July 20, 2021
In response to changes in our internal dependencies, we are freezing support of iOS 11 in an upcoming major version of Google Maps Platform SDKs for iOS.
Versions of Maps SDK for iOS released beginning the fourth quarter of 2021 will support a minimum of iOS 12. Earlier SDK versions will continue supporting iOS 11.
If your dependencies in CocoaPods or Carthage do not specify a version number, Xcode will load the newest version and new builds of your app will not support iOS 11.
Be sure to specify a version in your application's build dependencies in order to control when you raise the minimum supported OS for new versions of your app. See the guidance on app maintenance best practices.
Version 5.1.0 - June 28, 2021
- Fixed an issue with the generated module map for frameworks without headers.
- The background color of the map view has been slightly changed.
- Support for iOS 11 will be frozen in an upcoming major version.
Version 5.0.0 - May 13, 2021
- Support for iOS 10 is now frozen. The minimum OS is now 11.0.
- ARMv7 32-bit architecture no longer supported.
Version 4.2.0 - March 8, 2021
- Version bump, no changes. This version is functionally identical to v.4.1.0.
- Changes are coming in version 5.0.0:
- Support for iOS 10.0 will be dropped in version 5.0.0.
- To avoid unexpected errors, be sure to specify a version number in your Podfile or Cartfile. This will ensure that your builds remain stable against a known version, and will not switch to the next major version until you are ready to update your code.
Version 4.1.0 - December 8, 2020
- Added crash detection during SDK initialization. In cases where two or more
consecutive crashes are detected at initialization time, the SDK will attempt
to restore functionality by automatically resetting cached map tile data. A
recovery attempt event will be logged unless the client has opted out of
abnormal termination reporting via the
Version 4.0.0 - October 13, 2020
- Support for iOS 9.0 has been dropped. The new minimum is iOS 10.0.
- The new minimum version of Xcode is 11.7.
- By default, abnormal SDK terminations, such as app crashes while the SDK is
still running, are monitored. This allows Google to improve SDK stability when
applicable. There is also an option to opt-out by using the
Version 3.10.0 - August 10, 2020
- Version bump, no changes. This version is functionally identical to v.3.9.0.
- There is a new Maps Swift Demo App in Google Maps cocoapods.
- To build apps using the Maps SDK for iOS, the current minimum IDE version supported is Xcode 11.5.
Version 3.9.0 - May 26, 2020
- The demo app has been improved.
- Fixed issue where apps would crash when resizing map view in some circumstances (Issue 152145655).
- Fixed issue where apps would crash when particular custom styles were used (Issue 73344082).
- Some types of camera move animations were skipped if initiated before the map view had gone through a layout cycle (Issue 80065881).
Version 3.8.2 - May 18, 2020
- Fixed an issue where apps using the Maps SDK for iOS would crash upon startup.
Version 3.8.0 - February 18, 2020
- Version bump, no changes. This version is functionally identical to v.3.7.0.
- To build apps using the Maps SDK for iOS, the current minimum IDE version supported is Xcode 11.0.
Version 3.7.0 - December 2, 2019
- Version bump, minor bug fixes only. This version is functionally identical to v.3.6.0.
Version 3.6.0 - October 28, 2019
- Version bump, no changes. This version is functionally identical to v.3.5.0.
Version 3.5.0 - October 08, 2019
- Fixed missing info window title in dark mode on iOS 13 (Issue 137173762).
Version 3.4.0 - September 04, 2019
- Version bump, no changes. This version is functionally identical to v.3.3.0.
Version 3.3.0 - July 29, 2019
- Added the
SDKLongVersionmethod, which returns the long version of the Maps SDK for iOS.
- Fixed a long-standing intermittent crash on startup related to CoreData cache (Issue 111132807).
Version 3.2.0 - July 8, 2019
- Fixed an issue when rendering polygons that would result in incorrect shapes being drawn.
- Fixed a crashing bug that occurred occasionally when removing overlays from a map.
- Reduced the amount of work done when the map is hidden by other views to improve CPU usage.
Version 3.1.0 - April 16, 2019
- Indoor maps are now styled to match outdoor maps (Issue 35830576).
- Fixes an issue where a crash could occur if markup entities were added to the map before the map was ready to draw.
Version 3.0.0 - January, 2019
- Support for iOS 8.0 has been dropped. The new minimum is iOS 9.0.
- There is an occasional rendering bug when using the polygon overlay feature.
Old Style Removed - November 1, 2018
- Removed support for the old basemap style. The opt-in and opt-out API options (see below) are no longer supported. This applies to all versions of the Maps SDK for iOS. See the blog post for more information about the new style.
New Style Default - June 28, 2018
Enabled the new basemap style by default. You can still opt-out temporarily if you need time to modify your app to accommodate the new style. If you do, please follow Issue 72853293 which contains the timeline for end of support of the previous basemap style. We will be posting updates there as they are available.
To opt-out, use the code snippet below. The best place to do this in your app is right after providing your API key, via
GMSServices provideAPIKey. You must be using at least Version 2.6.0 in order to opt-out. If you had previously opted-in to the new basemap style, this should replace the code you added to opt-in. See the blog post for more information about the new style.
NSArray *options = @[@"B3H9HE845CFHYG"]; BOOL didSetApiOptions = [GMSServices provideAPIOptions:options]; NSLog(@“Options were set: %d”, didSetApiOptions);
Version 2.7.0 - April 18, 2018
- Improved documentation on thread safety of
- Fixed crash in
- Fixed Google Logo positioning in
- Support for Xcode 8.0 has been dropped. The new minimum is Xcode 9.0.
New Style Opt-In - February 13, 2018
Enabled opt-in for the new basemap style. To opt-in, use the code snippet below. The best place to do this in your app is right after providing your API key, via
GMSServices provideAPIKey. You must be using at least Version 2.6.0 in order to opt-in. See the blog post for more information about the new style.
NSArray *options = @[@"B3MWHUG2MR0DQW"]; BOOL didSetApiOptions = [GMSServices provideAPIOptions:options]; NSLog(@“Options were set: %d”, didSetApiOptions);
Version 2.6.0 - February 6, 2018
- Added a mechanism for developers to enable experimental features.
- Added a click listener to the My Location dot. This allows developers to respond to interactions with the My Location dot.
- Added a Source attribute to Panorama searches allowing them to be restricted to outdoor-only results. Note that this feature is experimental and some searches may still include indoor panoramas (Issue 72250080).
- Updated the default marker to match the new Google Maps marker.
- iOS 11 OpenGL crash reduction (Issue 68699629).
- Fixed a compile error when the
-Wobjc-property-no-attributeflag is used (Issue 65561405).
- CoreImage has been added as a dependency.
Version 2.5.0 - October 2017
- Added the paddingAdjustmentBehavior property to GMSMapView. This property controls how safe area insets interact with padding.
- Improved iOS 11 & iPhone X support. (Issue 64504919, Issue 63686068.)
- GMSMapView and GMSPanoramaView managed subviews are now positioned within iPhone X device safe areas by default.
- Fixed an issue where Xcode 9's Main Thread Checker warns that [UIApplication applicationState] is being called on a background thread. (Issue 63322270.)
- Fixed an issue where setting either navigationLinksHidden or streetNamesHidden to YES still resulted in the navigation links and street names appearing. (Issue 64210766.)
Version 2.4 - August 2, 2017
- Addressed a crash when using GMSPanoramaView with an application moving to the background state. (Issue 63665236.)
Version 2.3.1 - June 19, 2017
- Fixed an issue where navigating between panoramas did not consistently raise GMSPanoramaView delegate events. (Issue 62290311.)
- Fixed an issue resulting in a crash when UIWebView and GMSPanoramaView are both in the view hierarchy at the same time. (Issue 62279895.)
- Reinstated the tap-drag zoom gesture for GMSPanoramaView. (Issue 62218602.)
Version 2.3 - May 30, 2017
- The internals of the GMSPanoramaView and associated classes have had a significant overhaul. These changes should generally give improved performance.
- Dropped support for iOS 7, which enabled the use of modern core data threading models. This means that applications should be able to use -com.apple.CoreData.ConcurrencyDebug 1 when debugging with iOS 10 devices. (Issue 35829579.)
- Fixed case sensitivity issues with imports in GMSTileLayer.h and GMSPolyline.h. (Issue 35831050.)
Version 2.2 - February 14, 2017
- Added the
GMSMapView. This property restricts the camera target to the specified bounds area. Subsequent gestures are then also restricted to keep the camera target within the specified bounds.
GMSMarkerwas moved to its parent class
GMSOverlay. This enables the property to be used with the
- Fixes naming of certain enum cases in Swift. The following enums are
- Fixed an issue where the
mapViewSnapshotReadydelegate method was sometimes raised too early (Issue 10799.)
Version 2.1.1 - November 8, 2016
- Fixed an issue which caused many Road Shields to not be displayed when custom styling is active even if the custom styling didn't attempt to style them.
- Renamed some symbols which could cause duplicate symbols when using all_load and Firebase. (Issue 10631.)
- Resolved a problem where changing any property of polygon, polyline or ground overlay in between taps would cause tap cycling to break. This could make it seem impossible to tap through to items underneath. (Issue 10436.)
- Fixed cameraForBounds:insets: to respect the currently set min and max zoom restrictions. (Issue 10817.)
Version 2.1 - September 22, 2016
This release introduces custom styling of the base map (Issue 4968). You can use a JSON style declaration to create a
GMSMapStyleinstance and pass it to the
mapStyleproperty, to change the visual display of features like roads, parks, businesses, and other points of interest. You can use styling to emphasize particular components of the map, or make the map complement the style of your app. Styling works only on the
- See the quick guide to styling your map, using night mode as an example style.
- Use styling to prevent certain features from appearing on the map.
- Learn the full power of custom styling in the style reference.
Business points of interest (POIs) now appear by default on the map, provided that the map type is
kGMSTypeNormal. Prior to this release, local POIs appeared on the map, but not business POIs). Business POIs represent businesses such as shops, restaurants, hotels, and more. See the guide to points of interest.
You can hide POIs on a map by using map styling.
- Renamed the
canGoOfflineselector internally, to avoid triggering false positives during submission to the Apple app store. (Issue 10393.)
GMSMarkeris now correctly marked as nullable. (Issue 10391.)
- Renderer in iOS has been updated to avoid a race condition which would cause rendering to not stop in time when an app transitions to background. (Issue 10224.)
initFromEncodedPathnow returns nil for invalid input (previously invalid input could result in a crash). (Issue 10162.)
- An additional method was added to
GMSMapView, which compares two camera positions to determine whether they are close enough to render identically. (Issue 9494.)
GMSCirclewill now always draw at least a dot for small radius circles, including radius 0. (Issue 9528.)
Version 2.0.1 - July 29, 2016
- Array properties are now correctly typed when accessed from Swift. (Issue 10183.)
Version 2.0.0 - July 26, 2016
- This release splits the Places API from the Maps SDK. Previously, if you wanted to use the Places API you had to include all of GoogleMaps. As a result of the split, the final size of the Places API binary is 70% smaller than the previous combined binary. If you are using only the Maps SDK you will not be affected unless you have pinned your dependency on GoogleMaps to a version earlier than 2.0. In this case, you should update this restriction in your Podfile. If you are using the Places API, see Migrating to Places SDK for iOS.
- Places SDK demos are now available separately from Maps demo apps.
- The GoogleMaps binary has been reduced to less than 100MB to avoid exceeding GitHub's file size limit. (Issue 9030.)
- The Maps framework is now available as a download for manual installation. For details, see Get Started. (Issue 8856.)
- GMSGroundOverlays now correctly respond to touch input when rotated. (Issue 9544.)
- Marker info windows now render consistently (Issue 9670, Issue 9819.)
- Info windows created using the return value of mapView:markerInfoContents: will now correctly respect the height of the returned content rather than always being square based on the width.
- Fixed an issue where texture cache limit is exceeded on devices supporting @3x sized images. (Issue 9859.)
Utility library update - July 19, 2016
- The new marker clustering utility helps you manage multiple markers at different zoom levels on the map. By clustering your markers, you can put a large number of markers on a map without making the map hard to read. Get the utility library from GitHub, follow the setup guide, and see how to implement marker clustering in your app. (Issue 5723.)
Version 1.13.2 - May 12, 2016
- Added a workaround to avoid the false positive for the non-public API imageWithName: selector. (Issue 9704.)
Version 1.13.1 - May 02, 2016
- Fixed an application hang when using a UIView with autolayout enabled as an info window or as a marker iconView. (Issue 9525.)
- Changed lookUpPlaceID to not call its callback twice in error scenarios. (Issue 9310.)
Version 1.13.0 - March 29, 2016
- UIView based markers. Marker content can now show advanced animations by providing a custom view hierarchy to be displayed through the iconView property. See the documentation for details. (Issue 5203.)
- Info windows can now have their custom views animated. Set tracksInfoWindowChanges on the associated marker to YES to enable real-time updates. (Issue 5559.)
- Map rendering now defaults to 60fps on modern iOS devices. Set the new preferredFrameRate property on GMSMapView to revert to the old behavior (Conservative) or a new low frame rate option to save battery (PowerSave). (Issue 5066.)
- Added mapViewSnapshotReady: to GMSMapViewDelegate which fires when map content, including markers and other overlays, has been fully rendered.
- Autocomplete widgets in the Places API now provide options for custom styling.
- GMSCoordinateBounds initWithVisibleRegion: now chooses correct bounds for large viewports.
- Added a workaround to avoid a graphical glitch in snapshots taken using pre iOS 7 methods when the My Location button is disabled. (Issue 9173.)
- GMSAutocompleteViewController now works when used in a storyboard.
- Added missing Place Type constants. (Issue 8121.)
Version 1.12.3 - February 2016
- Fixed corruption in included bitcode that caused Xcode archive action to fail. (Issue 9368.)
- Added a workaround for a limitation in Xcode 6.4 which was failing to compile the included headers.
Version 1.12.2 - February 2016
- Added place photos to the Places API. (Issue 8202.)
- Added structured address components to GMSPlace objects. (Issue 8121.)
- SDK method signatures have been updated with generics and nullability annotations.
- GMSPlace objects now contain rating and price level where available.
- Minor bugfixes for the autocomplete widget UI.
- panoramaView:didMoveCamera: is no longer raised during the panoramaView delegate setter. (Issue 5630.)
- Old unused logo files have been removed from the SDK. (Issue 9148.)
- Tap events on polygons near the anti-meridian are more reliable.
- Resolved an issue resulting in unrecognized selector crashes when calling class methods on categories. (Issue 9000.)
Version 1.12.1 - February 2016
This version is exactly the same as 1.11.1. It was released to replace the removed 1.12.0 release.
Version 1.12.0 - February 2016
This version was removed because of errors in the framework and should not be used.
Version 1.11.1 - December 2015
- Modally presented Place Autocomplete widgets now correctly respect UINavigationBar appearance proxy settings.
- Resolved minor UI issues with the Place Autocomplete widgets.
- Updated GoogleMaps.bundle info.plist to avoid triggering checks in pre-submission verification. (Issue 8488.)
Version 1.11.0 - December 2015
- Bitcode is now included in the SDK binary for all device architectures. (Issue 8219.)
- Added Place Autocomplete widget classes.
- New events for long press on an info window, and closing an info window, have been added to GMSMapViewDelegate.
- GMSMapViewDelegate has new events to indicate when map tiles and labels are pending and finished rendering. (Issue 5430.)
- GMSPanoramaViewDelegate has new events to indicate when panorama tiles are pending and finished rendering. (Issue 5430.)
- GMSGroundOverlay now supports an alpha multiplier via the opacity property.
- Added a holes property to GMSPolygon to allow for the subtraction away from the filled area in order to create more complex shapes. (Issue 5464.)
- At zoom levels greater than 14, the maximum tilt has been increased. (Issue 5169.)
- Added an autocomplete screen to the Place Picker.
- Split autocomplete predictions into primary and secondary text fields.
- Added a country filter option to GMSAutocompleteFilter.
- Added a viewport field to GMSPlace.
- Correct handling of taps on overlapping markers. (Issue 7587, Issue 8591.)
- Address a race condition dependent crash which can happen when an application enters and leaves the background while showing a map. (Issue 7011.)
- Fix blank maps which can happen when launching an app into the background. (Issue 8510.)
- Workaround issues with core animation that caused markers to jump. (Issue 8451.)
- Updated to avoid subtle conflicts with applications which use google-toolbox-for-mac.
- Use the iPhone language instead of the region formatting language for Places API results (Issue 8536.)
Notes - Setting GMSMapView selectedMarker to a marker not on the map is now ignored, always set the marker's map property before attempting to select it.
Version 1.10.5 - October 2015
- Worked around an issue in the Swift compiler's handling of umbrella header module entries. (Issue 8524.)
Version 1.10.4 - October 2015
- Fixed a crash on iOS 9 when dismissing the place picker without a selection. (Issue 8672.)
- Fixed a crash when using both a GMSMapView and a UIWebView or WKWebView in the view hierarchy at the same time. (Issue 8343.)
- Recompiled with Xcode 7 to avoid raising failed to load optimized model log messages on iOS 9 devices. (Issue 8459.)
Version 1.10.3 - September 2015
- Google logos have been updated.
- Framework now ships with the device version of bundles to pass Xcode 7 archive checks. (Issue 8568.)
Version 1.10.2 - August 2015
- Fixed a crash releasing a map view while in background. (Issue 8200.)
- Resolved a conflict with apps using gtm-session-fetcher resumable downloads.
- Recompiled with Xcode 6.4 to avoid some bugs in Xcode 6.3 compiler.
- Updated GoogleMaps.bundle info.plist to avoid triggering new checks in pre-submission verification. (Issue 8488.)
Version 1.10.1 - June 2015
- Fixed an issue where instantiating GMSPlacesClient triggered a request to the user to enable Bluetooth on the device.
- Miscellaneous improvements to the GMSPlacePicker UI.
Version 1.10.0 - May 2015
- The Places SDK for iOS is now included in the SDK framework, so you can connect people to places in your iOS apps. If you want to use the Places SDK for iOS in your project, please refer to the getting started guide.
- CocoaPods is now the fully-supported means of installing and upgrading the Maps SDK for iOS. CocoaPods is an open source dependency manager for Swift and Objective-C Cocoa projects. Below is a short guide to migrating from earlier versions of the Maps SDK for iOS. See the getting started guide for full instructions.
- A new
GMSUISettingsallows you to control whether the user can scroll by panning during multi-touch rotate or zoom gestures. (Issue 7737.)
GMSPanoramaViewnow supports being used in storyboard.
GMSGeocodernow supports being used while the app is in the background.
GMSServices sharedServicescan now be called while the app is in the background. Note that if the first call to
sharedServicesoccurs while the app is in the background, some async initialization work will be deferred until the first time a map is shown where it will be performed synchronously.
GMSPanoramaViewinit messages can now be handled while the app is in the background. This should remove the last case where
GMSPanoramaViewcould not be used in the background. (Issues 7860, 8007, 8037, 7896, 7951.)
GMSPanormaViewdelegate properties now support
IBOutletfor easier use in storyboard. (Progress towards a fix for issue 6866.)
mapView:didTapMyLocationButtonForMapView:is now correctly called even if no location is available. (Issue 7742.)
GMSGroundOverlaynow shows correctly when rotated if image aspect ratio doesn't match the selected ground region. (Issue 7772.)
- Fixed an issue resizing the map on iOS 8.
- Fixed a rare crash under fast camera changes. (Issue 7885.)
- Map no longer hangs when adding a ground overlay with certain invalid bounds. (Issue 7701.)
- Fixed a crash when texture memory is exhausted by markers. (Issue 7638.)
- Correctly returns the tapped
mapView:didTapOverlay:for tappable circles. (Issue 6890.)
mapView:idleAtCameraPosition:is now called even if there is an ongoing update of the My Location dot. (Issue 7889.)
- Due to an ABI change in the Xcode compiler, Xcode 6.3 is now the only supported version for compiling against Maps SDK for iOS. (Issue 7900.)
- The minimum target iOS version for Maps SDK for iOS is now 7.0. Version 6.0 is no longer supported.
Versions 1.9.2 and earlier of the Maps SDK for iOS were available as a zip file containing a static framework. There was also the option to install recent versions from a CocoaPods pod. From version 1.10.0 onwards, the Maps SDK for iOS is available for installation only via CocoaPods.
If you previously installed the Maps SDK for iOS from a zip file containing a static framework:
- Remove all references to the previous framework from your Xcode project.
- Follow the instructions in the getting started guide to install the Maps SDK for iOS using CocoaPods.
If you previously installed the Maps SDK for iOS from the
- Change your pod name to
Version 1.9.2 - February 2015
Download version 1.9.2.
- Show correct characters for Myanmar place labels. (Issue 7576)
- Fixed a small memory leak related to font registration. (Issue 7559)
- Fixed a large memory leak in rare cases where My Location is enabled and the user rotates the screen.
- Correctly show ground overlays defined by zoom level which extend across more than 180 degrees of longitude.
- Allow selected marker to be set during
mapView:didTapAtCoordinate:. (Issue 7222)
- Throw exception rather than crash when map services are initialized while the application is in the background.
mapView:idleAtCameraPosition:even for swipe motions which last less than 30ms. (Issue 7206)
- Correctly handle animations starting while a gesture is decelerating. (Issue 7348)
- Always return an error from
GMSPanoramaServicecallbacks if the panorama is nil.
- Don't attempt to navigate to an empty panorama if
moveNearCoordinate:resolves to nil. (Issue 7109)
Version 1.9.1 - December 2014
Download version 1.9.1.
- Added workaround for false positive on
userEmailprivate selector. (Issue 7310)
- Improved handling of info windows for iPhone 6+ running applications in scaled mode. (Issue 7323)
Version 1.9.0 - October 2014
Download version 1.9.0.
- Support for iOS 8.
- Support for iPhone 6/6+. (Issue 7140)
- Support for Swift.
- UI elements have been updated for material design.
- Fixed some memory reclamation issues.
- Improved handling of application background state transition.
- In order to improve compatibility with Swift, two geometry library
functions have been renamed to avoid function overloading.
The new names are
Version 1.8.1 - May 2014
Download version 1.8.1.
- Resolved GMSTileLayer not displaying. (Issue 6686)
- Resolved a rare case where an app would crash when displaying polylines while accessibility features are enabled. (Issue 6689)
mapView:willMove:is no longer called alongside a tap gesture. (Issue 6702)
- Resolved symbol collisions with the Protocol Buffer library.
Version 1.8.0 - May 2014
Version 1.8.0 has been replaced by version 1.8.1 and is no longer available for download.
- Resolved threading deadlock prominent on iPhone 4 running iOS 7.1 or later. (Issue 6484, Issue 6524)
GMSMapViewcorrectly releases some shared GL state previously causing memory leak. (Issue 5941, Issue 6265, Issue 6629)
GMSPolylineno longer crashes in some cases where its path contained more than 1024 segments. (Issue 6542)
- The delegate method
mapView:idleAtCameraPosition:is now only called once all user gestures are complete. (Issue 5718)
- The Maps SDK for iOS now includes fonts for languages currently
unsupported by the iOS system, such as Khmer. (Issue 5228)
- These fonts may be safely removed from your
GoogleMaps.frameworkif you have no interest in these regions, but some text may render as "[?]".
- These fonts may be safely removed from your
Version 1.7.2 - March 2014
Download version 1.7.2.
GMSPolyline's are no longer grayscale on iOS 7.1.
Version 1.7.1 - March 2014
Version 1.7.1 has been replaced by Version 1.7.2 and is no longer available for download.
- Heading will only appear on My Location dot when available.
- Better reduction of colors on gradient or colored polylines at low zoom. (Issue 6386)
- The search radius is now respected when retrieving a
GMSPanoramaViewconstruction or move.
Version 1.7 - February 2014
Version 1.7 has been replaced by Version 1.7.2 and is no longer available for download.
- Styled polylines: additional color options via
GMSPolyline, including gradients and colors for any number of polyline segments. (Issue 4856)
- Each polyline may be drawn with many
GMSStyleSpaninstances, configuring a unique color or gradient over an arbitrary number of segments.
- Gradient or color may be specified via a
GMSPathprovides a helper category to determine distance along a path.
GMSStyleSpanshelper to apply repeated styles along a polyline.
- Each polyline may be drawn with many
GMSGeocodernow provides structured addresses via
- Added mutable version of
- Delegate method for user tapping the My Location button.
GMSMapPointfor linear interpolation between points in Mercator space on the Earth.
- My Location dot now shows compass arrow. (Issue 5325)
- 3D building data is newly available for many places on the Earth.
GMSPolylinewidth is much closer to screen width. (Issue 5788, Issue 5265)
GMSPolylineperformance and memory improvements. (Issue 4904)
- Reduced memory use of OpenGL textures.
- Floor picker is positioned correctly when My Location button is disabled. (Issue 5742)
GMSMapViewnow correctly accounts for padding. (Issue 6080)
- To align with other Google Maps APIs,
GMSMapViewno longer provides helper methods to retrieve previously added overlays, such as
Version 1.6.2 - January 2014
Download Version 1.6.2.
- Resolved a gesture bug effecting full-screen maps on iOS 7. (Issue 6216)
- Resolved an issue where overlays were sometimes not initially tappable. (Issue 6143)
Version 1.6.1 - December 2013
Version 1.6.1 has been replaced by version 1.6.2 and is no longer available for download.
- Resolved a memory leak involving vector tiles.
- Markers not immediately added to a GMSMapView no longer fail to appear when configured at a later point. (Issue 6092)
- GMSMapView/GMSPanoramaView will now continue to render while your application is resigned. (Issue 5546)
Version 1.6 - November 2013
Version 1.6 has been replaced by version 1.6.2 and is no longer available for download.
- The Maps SDK for iOS now supports 64-bit architectures. Both 32 and 64 bit binaries are built into the single GoogleMaps framework. The correct binary will be selected by Xcode based on your build settings. For instructions on building 64-bit applications, please refer to Apple’s 64-bit transition guide. (Issue 5806)
- Changed some instances of
CGFloatto either a
doublewhere it was more appropriate.
- Added the ability to restrict min and max zoom on
GMSMapView. (Issue 5882)
- Added opacity on
- Core Animation on
GMSMapViewnow requires model values to be set
- Info windows and tappable regions now rotate correctly with markers. (Issue 5896, Issue 5969)
- Padding on a
GMSMapViewis no longer clamped to its bounds (useful if setting padding on an initially zero-sized map). (Issue 5864)
- Copyright information now animates when changing
GMSMapViewsize or padding.
- Info windows are removed if their
GMSMarkeris removed from a
GMSMapView. (Issue 5856)
- My Location dot uses the last known location information when enabled. (Issue 5590)
- Resolved two rare race conditions that were causing crashes. (Issue 5795)
- Resolved an issue where retain cycles were causing memory leaks on
Version 1.5 - September 2013
Download Version 1.5.
- This release officially supports iOS 7, and requires iOS 6.0 or later (iOS 5.1 is no longer supported).
- The 'animated' field on
GMSMarkeris now known as
appearAnimation, and may be set to
- The Maps SDK for iOS now ships with an
armv7sslice. (Issue 4745)
- Several new features for
- Markers can be made draggable using the
draggableproperty, and new drag delegate methods have been added to
GMSMapViewDelegate. (Issue 4975)
GMSMarkerLayer, a custom
GMSMarkerthat supports animation of marker position and rotation. (Issue 4951, Issue 5743)
- Changing a markers
positionwill cause the marker to animate to the new location.
- Added support for markers that appear flat against the Earth's surface.
- Added rotation property to rotate markers around their ground anchor.
GMSMarkernow supports the images and duration properties, and will animate images with multiple frames.
alignmentRectInsets, and will adjust
infoWindowAnchor, and the tappable region. (Issue 5729)
- Markers can be made draggable using the
- Added padding on
GMSMapView, allowing you to indicate parts of the map that may be obscured by other views; setting padding re-positions the standard map controls, and the camera and camera updates will use the padded region. (Issue 5466, Issue 5728)
GMSPanoramaServicenow support searching for panoramas with custom radius.
GMSMapView, allowing construction of a
GMSCameraPositionfor the map from a specified
- The "My Location" button now clips within
GMSMapView. (Issue 5764)
- Reduced memory usage of
GMSMapViewthrough less aggressive tile caching. (Issue 5202)
- Reduced the time taken to obtain
GMSServicesby moving some startup tasks to a background thread; obtaining this object early in your application (before creating a
GMSMapViewor other objects) may improve performance. (Issue 5640)
- Polylines may now be drawn twice, as required, if they have very large longitudinal span.
- Resolved a rounding error with very small polygons far from latlng (0,0). (Issue 5413, Issue 5654)
Migration from 1.4.x:
- Version 1.5 requires iOS 6.0 or later. Applications that must support iOS 5.1 should continue to use the most recent 1.4.x release.
animatedproperty of GMSMarker has been replaced with the new field:
appearAnimation. To maintain previous behavior, replace all references to the
animatedproperty as follows:
marker.animated = YES;
Should be replaced with:
marker.appearAnimation = kGMSMarkerAnimationPop;
Changes to the
positionproperty are now animated. You can disable this animation with the following sample code.
[CATransaction begin]; [CATransaction setDisableActions:YES]; marker.position = ...; [CATransaction commit];
Version 1.4.3 - August 2013
- Resolved several causes of modifying markers that could cause 'ghost' markers to appear. (Issue 5751)
- Resolved excess texture use when modifying animated markers. (Issue 5756)
Version 1.4.2 - August 2013
- Fixed a rare case where modifying an animated marker could cause 'ghost' markers to appear.
- Prioritized markers over other overlays for tappability.
Version 1.4.1 - August 2013
- Tappable markers inside
panoramaView:didTapMarker:delegate method on
GMSPanoramaViewDelegate. (Issue 5622)
GMSPanoramaLayer, a custom
GMSPanoramaViewthat supports animation of the panorama camera.
GMSPanoramaCamerasupports custom field of view (FOV).
- Programmatic access to the floor picker allows you to enable or disable the selector, and set which floor should be displayed. (Issue 5623, Issue 5666)
GMSTileLayernow supports high DPI tiles for use on a Retina device. (Issue 5402)
GMSMapView.camerais now observable via KVO.
GMSCameraUpdate. (Issue 5475)
- The default behavior of a
GMSMapViewto consume all gestures within its bounds may now be disabled via
consumesGesturesInView. (Issue 5552)
GMSGeometryUtilsto include additional helper methods.
GMSServicesmay be held by applications to maintain cache and connection to Google; this can improve performance when creating and destroying many maps.
- Improved visuals when resizing a
- Fixed crash bug during memory warning (related to indoor). (Issue 5637)
- Fixed crash bug with indoor maps on iOS 5.1. (Issue 5664)
- Performance improvements when using hundreds of
- Reduced memory footprint of
- Touch target for
GMSMarkersmatches the size and shape of the marker when the
GMSMapViewis tilted. (Issue 5273)
GMSMapViewwill no longer render a single frame of black in some cases (noticeable e.g., inside
- Street View imagery is now adjusted correctly for tilted base data (e.g., data taken by a Street View car on a slope).
- Geodesic interpolation has been tweaked to be more correct.
- Fixed incorrect
GMSGroundOverlaysizing that prevented some images from displaying. (Issue 5663)
GMSCameraUpdatenow correctly applies padding to all edges of the bounds; previously it used 1/2 padding on each edge.
Version 1.4.0 - July 2013
- Support for Google Street View imagery, with coverage in 50+ countries.
GMSPanoramaView, a viewer for Street View imagery, that enables both programmatic and user control.
GMSMarkers can be shared between
GMSPanoramaServicemay be used to load panorama data ahead of display.
- Indoor floor plans and a floor selector control will now be displayed when available.
- Updated map design inspired by the new Google Maps.
- Info windows now show at 1:1 resolution on the screen regardless of tilt.
- Additional delegate methods on
mapView:idleAtCameraPosition:— allow you to detect the start and end of camera movement, respectively.
- An improved look and feel for polylines and polygon stroke.
- Added a
zIndexproperty on all overlays. Z-Indexes are calculated in two groups:
GMSMarkers and all other overlays.
GMSGeometryUtilsmethods for heading, distance, offset etc. with respect to points on the Earth.
- To align with other Google Maps APIs,
GMSGroundOverlayno longer supports the
zoomLevelproperty. You can use the helper method
groundOverlayWithPosition:icon:zoomLevel:to migrate existing code.
- Improved the tappability of
- The compass now disappears when the map returns to zero bearing for any reason, including animation.
- Resolved crash issue when creating a zero-sized
- Resolved an issue where active gestures could cause a
GMSMapViewto not be released until deceleration completed.
- Info windows no longer allow taps to pass through them.
- Accessibility elements on
GMSMapVieware now hidden by default. See the migration steps below if you wish to enable these elements.
Migration from 1.3.x:
Version 1.4 introduces changes to accessibility and ground overlays. If you make use of either of these in your application, you will have to modify any existing code as follows:
If your application relies on the accessibility elements of
GMSMapView, set the
mapView_.accessibilityElementsHidden = NO;
Replace direct references to the
zoomLevelproperty with the new
groundOverlayWithPosition:icon:zoomLevel:convenience method. Alternatively, you can position the image with a geographic bounds. The below code samples are equivalent.
Version 1.3.x assigned zoomLevel directly.
GMSGroundOverlay *groundOverlay = [[GMSGroundOverlay alloc] init]; groundOverlay.icon = [UIImage imageNamed:@"newark_nj_1922.jpg"]; groundOverlay.position = CLLocationCoordinate2DMake(40.742, -74.174); groundOverlay.zoomLevel = 13.6;
In version 1.4 and later, you can use the convenience method.
GMSGroundOverlay *groundOverlay = [GMSGroundOverlay groundOverlayWithPosition:newark icon:[UIImage imageNamed:@"newark_nj_1922.jpg"] zoomLevel:13.6];
From this release, we recommend that you position your ground overlay by defining its south west and north east corners.
CLLocationCoordinate2D southWest = CLLocationCoordinate2DMake(40.712216,-74.22655); CLLocationCoordinate2D northEast = CLLocationCoordinate2DMake(40.773941,-74.12544); GMSCoordinateBounds *overlayBounds = [[GMSCoordinateBounds alloc] initWithCoordinate:southWest coordinate:northEast]; UIImage *icon = [UIImage imageNamed:@"newark_nj_1922.jpg"]; GMSGroundOverlay *overlay = [GMSGroundOverlay groundOverlayWithBounds:overlayBounds icon:[UIImage imageNamed:@"newark_nj_1922.jpg"]];
Version 1.3.1 - June 2013
- Shows all tiles when animating across the antimeridian
- Performance improvements while zooming
- Touches are consumed more agressively by
- Fixed constructing a
- Restores OpenGL state correctly in
GMSMapViewin applications that also use
Version 1.3 - May 2013
- Support for custom tile overlays (image-based) via
- Anti-aliasing for
- Support for 'invisible' base map tiles via
- Basic support for
- Performance improvements with large numbers of overlays.
- Resolved excessive memory use when device was locked/unlocked while an info window was displayed
- Animations are stopped when a user performs a gesture
- Animations stop any active gesture (e.g., a pan)
- Resolved crash issue with setting/clearing My Location dot
GMSPolygonnow support greater precision at high zoom
GMSPolygonuse the correct alpha values
- Touches are consumed by
GMSMapView, allowing use within objects such as a scroll view
Version 1.2.2 - April 2013
- Tappable regions for
- Overlays are no longer able to render on half pixels.
- Ground overlays appear underneath the My Location dot.
strokeColoris no longer erroneously deallocated.
Version 1.2 - April 2013
- You can now create overlays directly, without the need for an associated
options class. The
GMS...Optionsclasses have been removed from this release.
- Map overlays, such as
GMSPolyline, now inherit from a shared
- Added support for two new overlays,
GMSPolylinehave been renamed to
- Overlay types may now be subclassed.
- Additional helper methods have been added to
includingmethod has been renamed to
GMSMarkermay be animated when added to a map.
GMSCameraUpdateto create camera update objects, including operations to set a camera that presents a specified
GMSUISettingsmay be used to add a compass or "My Location" button (disabled by default).
- Non-marker overlay types are tappable (see
- The default marker image has been changed to the Google Maps for iOS marker.
markerImageWithColor:to create tinted versions of the default marker.
GMSMapView, now supports modification of its camera properties, allowing for advanced animation effects.
visibleRegionnow reports correctly sized region on Retina Devices.
- Double-tap to zoom now centers around tapped point.
- Disabling pan via
UISettingsnow prevents movement with zoom gestures.
GMSPolylineperformance is improved for large polylines.
GMSMapViewmay be subclassed.
- My Location dot appears underneath markers.
- Performance improvements when using the My Location dot.
- Grayscale polylines now render correctly.
GMSMapViewlayer now renders correctly; this allows for snapshots and UI effects.
- The default behavior when a marker is tapped has been updated to also pan the camera to the marker's position.
Migration from 1.1.x:
When upgrading to the most recent version, you will have to modify any existing code as follows:
- Replace references to the
strokeColor. The behavior is otherwise the same.
- Replace calls to the
GMSCoordinateBoundswith a call to
- Version 1.2 simplifies overlays (items added to the map) by allowing you
to set overlay options directly on the object, instead of first creating
an overlay options object. This change impacts existing code as follows:
- Remove all references to
GMSPolylineare now concrete classes, not protocols. Specify them as
GMSMarker *, instead of
- Add an overlay to the map by setting its
mapproperty instead of calling the
- Remove an overlay from the map by setting its
nil(rather than calling
- Values previously set on properties of an options object should now be set on the object itself.
- Remove all references to
Below is an example of how to add a polyline to the map in version 1.1:
GMSPolylineOptions *lineOptions = [GMSPolylineOptions options]; GMSMutablePath *path = [GMSMutablePath path]; [path addCoordinate:CLLocationCoordinate2DMake(37.35, -122.0)]; [path addCoordinate:CLLocationCoordinate2DMake(37.45, -122.0)]; lineOptions.color = [UIColor blueColor]; lineOptions.path = path; id<GMSPolyline> line = [mapView_ addPolylineWithOptions:lineOptions];
The equivalent code in version 1.2.0 and later is:
GMSMutablePath *path = [GMSMutablePath path]; [path addCoordinate:CLLocationCoordinate2DMake(37.35, -122.0)]; [path addCoordinate:CLLocationCoordinate2DMake(37.45, -122.0)]; GMSPolyline *line = [GMSPolyline polylineWithPath:path]; line.strokeColor = [UIColor blueColor]; line.map = mapView_;
Version 1.1.2 - March 2013
- Updated the SDK to use libc++ instead of libstdc++.
- Improved support for including a
GLKViewin the same app.
Migrating from v1.1.1 or earlier:
Version 1.1.2 and later use libc++ instead of libstdc++. To upgrade to the most recent version of the SDK, do the following:
- In the Project Navigator, replace the previous framework with the most recent framework.
- Select your project from the Project Navigator, and choose your application's target.
- Open the Build Phases tab, and within Link Binary with Libraries:
- Recompile your project.
Version 1.1.1 - March 2013
- Improved the messages that are logged to the console when a invalid key is used or a connection error occurs.
- Added multi-line snippet support for
GMSMapViewcould return a
GMSMapViewinstances no longer 'camera crosstalk'.
- The SDK contained unresolved external references.
GMSMarkerwith an empty title and snippet no longer shows an empty info window.
Version 1.1 - February 2013
- The points of a
GMSPolylineOptions) are now specified as a
GMSPathand built via a
GMSMutablePath, rather than
GMSPolylinemay now be specified as geodesic.
animateToLocation:now clamp/wrap latitude/longitude respectively; similarly, bearing is clamped to
0 <= bearing < 360
GMSGroundOverlaymay be modified after creation.
GMSPolylinemay cross the antimeridian
- Resolved a marker sorting issue.
Version 1.0.2 - January 2013
- GMSCamera was changed to GMSCameraPosition
- Removed requirement to call start/stopRendering
- Improved texture memory handling
- Added UISettings to control gesture availability
- Added Ground Overlays
- Fixed: GMSMapViewDelegate's mapView:didTapInfoWindowOfMarker: method is unreliable
- Selected markers are automatically brought to front
- Polylines now render at a constant size regardless of the zoom level
Version 1.0.1 - December 2012
- Initial release alongside Google Maps for iOS.
- Support for 3D maps, rotation, tilt, 3D buildings, markers, polylines.
- Satellite and terrain tiles, traffic data, and other features.