Maps SDK for iOS release notes (original) (raw)

Subscribe to these release notes.Subscribe

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. You can also browse and filter all release notes for all products in theGoogle API Console.

Consult the Getting Started documentation for information on how to download the most recent version of the Maps SDK for iOS.

May 19, 2025

10.0.0

The Maps SDK for iOS version 10.0.0 is now available. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed. If you are a new user, see Set Up in the Google Cloud Console to start the installation process. If you are an existing customer, see the upgrade instructions at Versions.

According to the Mobile OS version support policy, we are freezing support for iOS 15 as of Maps SDK for iOS v10.0.0. The new minimum supported OS is iOS 16. Earlier SDK versions will continue supporting iOS 15.

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 15.

Specify a version of the Maps SDK for iOS in your application's build dependencies in order to control when you raise the minimum supported OS for new versions of your app.

**The compass button in active navigation mode has been updated.**The size and style has been updated to match other Google Maps Mobile offerings, though the default position has not changed. To avoid driver distraction, the compass will remain in the same position if the header (in portrait mode) expands and conflicts with the default position of the compass. If you add a secondary header custom control or header accessory view, the compass is now hidden to avoid UI conflicts. The compass now supports day and night modes, as well as dark mode.

The default behavior is updated to display automatic dark mode to match Apple norms and accessibility requirements. Previously, the default was to always display light mode. You can set this back to the UIUserInterfaceStyle.light interface style if you would like your app to only display light mode.

The mapViewDidFinishTileRendering API is not invoked in no-network conditions.

In the next major version of Maps SDK for iOS, compassButton in GMSUISettings will be shown by default.

The new minimum supported version of Xcode is 16.0.

March 24, 2025

9.4.0

The Maps SDK for iOS version 9.4.0 is now available. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed.

If you are a new user, see Set Up in the Google Cloud Console to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

We are ramping up PanoramaView to use the Metal renderer instead of the OpenGL renderer. This change should not be noticeable to the human eye and will have full feature parity. This will fix certain simulator rendering issues by enabling PanoramaView to work in simulator on Xcode versions that no longer support OpenGL on simulators. Our public issue tracking event is here: https://issuetracker.google.com/issues/383046157. Please report any relevant issues you find during this gradual rollout.

January 27, 2025

9.3.0

The Maps SDK for iOS version 9.3.0 is now available. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed.

If you are a new user, see Set up your Google Cloud project to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

As of this release, crosswalks, sidewalks, and road lane markings may be visible on the map in certain metropolitan areas worldwide. Lane markings may not be visible on all roads even in areas where they are supported. The areas where these elements are visible may vary over time. When visible, crosswalks and sidewalk elements can be styled using Cloud Based Map Styling.

The Google Maps binary now strips any code that isn't referenced by public API classes. The size of the resulting binary is smaller by approximately 45%.

Swift Preview no longer breaks when the Maps SDK for iOS is added using Swift Package Manager.

November 18, 2024

9.2.0

The Maps SDK for iOS version 9.2.0 is now available. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed.

If you are a new user, see Set up your Google Cloud project to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

Updated API reference. The look and organization of the Maps SDK for iOS API reference has changed.

Note: The URLs for the API references pages have changed, so any pages you may have bookmarked will redirect you to the API reference homepage.

Visit the new API reference.

August 28, 2024

9.1.1

Bug fixes.

August 14, 2024

9.1.0

The Maps SDK for iOS version 9.1.0 is now available. Version bump, no changes. This version is functionally identical to v.9.0.0. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed.

If you are a new user, see Set up your Google Cloud project to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

May 28, 2024

9.0.0

Release 9.0.0

The Maps SDK for iOS version 9.0.0 is now available. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed.

If you are a new user, see Set up your Google Cloud project to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

According to the Mobile OS version support policy, we are freezing support for iOS 15 in an upcoming major version of Maps, Places, and Navigation SDKs for iOS.

Versions of Maps, Places, and Navigation SDKs for iOS released beginning the second quarter of 2025 will support a minimum of iOS 16. Earlier SDK versions will continue supporting iOS 15.

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 15.

Specify a version of the Maps, Places, and Navigation SDKs for iOS in your application's build dependencies in order to control when you raise the minimum supported OS for new versions of your app.

According to the Mobile OS version support policy, we are freezing support for iOS 14 as of Maps SDK for iOS v9.0.0. The new minimum supported OS is iOS 15. Earlier SDK versions will continue supporting iOS 14.

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 14.

Specify a version of the Maps SDK for iOS in your application's build dependencies in order to control when you raise the minimum supported OS for new versions of your app.

You can now use data-driven styling for datasets with your apps. Data-driven styling for datasets lets you upload your own geospatial datasets, apply custom styling to their data features, and display those data features on maps.

For more information and examples, see Data-driven styling for datasets.

Updated the default colors for maps to match the new colors that are already available in the Google Maps app. For more information, see New map style for Google Maps Platform.

The Apple Privacy Manifest file is now included in the resources bundle for the SDK. For more information, see Inspect the privacy manifest file.

You can now set the map color scheme to dark, light, or to use the system settings.

For more information and examples, see Map color scheme.

Simplified the install process when using the Swift Package Manager by changing the dependencies for the Maps SDK for iOS. Previously, you had to add dependencies for GoogleMapsBase, GoogleMapsCore, and GoogleMaps to your project. With this release, you only have to add GoogleMaps. We have also removed GoogleMapsM4B from the Maps Swift package.

Because of this change, if you upgrade from an older version to 9.0.0, you need to remove GoogleMapsBase, GoogleMapsCore, and GoogleMapsM4B from your project dependencies after you upgrade to version 9.0.0.

Since Apple has deprecated OpenGL support as of iOS 12 (2018), support for the OpenGL renderer and the setMetalRendererEnabled boolean in the Maps SDK for iOS is deprecated as of v9.0.0 , and will be unsupported in the major version that will be released in the second quarter of 2025.

Instead, use the Metal renderer, which has been default since Maps SDK for iOS v8.0.0, and remove setMetalRendererEnabled from your codebase.

April 01, 2024

8.5.0

With the release of the Places SDK for iOS version 8.5, the latest version of the Maps SDK for iOS remains v.8.4.0.

8.4.0

The new minimum supported version of Xcode is 15.0.

February 20, 2024

8.4.0

To streamline the SDK, the obsolete GoogleMapsM4B module in the Maps SDK for iOS is deprecated as of February 2024, and will be unsupported in the major version that will be released in the second quarter of 2025.

Since the GoogleMapsM4B module is related to an obsolete billing plan, it is safe to remove dependencies on the legacy GoogleMapsM4B module in your app. If you use CocoaPods to install the Maps SDK for iOS, remove the GoogleMapsM4B pod from the list of dependencies in your Podfile. If you manually install the Maps SDK for iOS, remove the GoogleMapsM4B framework from your project.

February 05, 2024

8.4.0

Release 8.4.0

The Maps SDK for iOS version 8.4.0 is now available. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed.

If you are a new user, see Set up your Google Cloud project to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

234007610 : Fix for zoomed out Polyline rendering on Metal.

December 14, 2023

8.3.1

Release 8.3.1

Infrastructure update. The Maps SDK for iOS now supports Swift Package Manager.

Using Xcode's Swift Package Manager integration, you can add or update the Maps SDK dependency directly from Xcode. Select the version of the Maps SDK for iOS that you want to use. For new projects, Google recommends you specify the latest version and use the option "Exact Version".

To learn how to add the Maps SDK for iOS to a project through Swift Package Manager, see the Set up an Xcode project guide.

November 28, 2023

8.3.1

Fixed a crashing bug for Maps SDK.

November 14, 2023

8.3.0

Release 8.3.0

The Maps SDK for iOS version 8.3.0 is now available. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed.

If you are a new user, see Set up your Google Cloud project to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

The Google Maps Platform now offers updated cloud-based maps styling in the Google Cloud Console, enhancing your ability to create a customized map experience for users of your iOS applications. Learn more at New Cloud Styling Overview.

When initializing your map view, configuration options are now set with GMSMapViewOptions. Option properties include the frame, camera, mapID or backgroundColor. For developers who subclass the GMSMapView, you will also need to update your initializer.

The new GMSMapViewOptions backgroundColor property allows you to override the default map background color.

October 05, 2023

8.0.0

Infrastructure update. For versions of Maps SDK 8.0.0 or greater, the default renderer has been changed to Metal. We encourage customers to remove calls to GMSService.setMetalRendererEnabled from their code as this method will be deprecated.

September 19, 2023

8.0.0

See the Release Notes for information about this update and for all previous updates or subscribe to the Release Notes XML feed.

If you are a new user, see Set up your Google Cloud project to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

As of version 8.0.0, the Maps SDK now supports advanced markers. With advanced markers you can customize the default marker's background, border, glyph text, collision behavior and replace the default marker icon with a custom graphic image.

For more information, see the advanced markers overview.

As of version 8.0.0, the Maps SDK now supports data-driven styling for boundaries. Data-driven styling for boundaries lets you access Google's polygons for administrative boundaries, apply styling to boundary polygons, display them on your maps.

For more information, see the data-driven styling for boundaries overview.

September 05, 2023

8.2.0

Release 8.2.0

The Maps SDK for iOS version 8.2.0 is now available. Version bump, no changes. This version is functionally identical to v.8.1.0. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed.

If you are a new user, see Set up your Google Cloud project to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

July 24, 2023

8.1.0

Release 8.1.0

The Maps SDK for iOS version 8.1.0 is now available. Version bump, no changes. This version is functionally identical to v.8.0.0. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed.

If you are a new user, see Set up your Google Cloud project to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

May 17, 2023

8.0.0

Release 8.0.0

The Maps SDK for iOS version 8.0.0 is now available. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed.

If you are a new user, see Set up your Google Cloud project to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

According to the Mobile OS version support policy, we are freezing support for iOS 13 as of Maps SDK for iOS v8.0.0. The new minimum supported OS is 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.

Specify a version of the Maps SDK for iOS in your application's build dependencies in order to control when you raise the minimum supported OS for new versions of your app.

Sprite Stamped polylines are now supported with the Metal Framework. This allows you to create a polyline using a repeating bitmap image of your choice. Shapes show with a clear background stroke, but the stamp is not truncated around line corners - making them useful for situations such as dots for illustrating walking directions. For more information see Sprite Stamped Polylines.

The new mapCapabilities property on GMSMapView adds programmatic checking for map-specific features. Included is support for Sprite Stamped Polylines. For more information see Map Capabilities.

May 15, 2023

7.4.0

Freezing support for iOS 14

According to the Mobile OS version support policy, we are freezing support for iOS 14 in an upcoming major version of <maps|places|navigation|driver|consumer> SDK for iOS.</maps|places|navigation|driver|consumer>

Versions of Maps SDK for iOS released beginning the second quarter of 2024 will support a minimum of iOS 15. Earlier SDK versions will continue supporting iOS 14.

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 14.

Specify a version of the Maps SDK for iOS in your application's build dependencies in order to control when you raise the minimum supported OS for new versions of your app.

February 27, 2023

7.4.0

Release 7.4.0

The Maps SDK for iOS version 7.4.0 is now available. Version bump, no changes. This version is functionally identical to v.7.3.0. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed.

If you are a new user, see Set up your Google Cloud project to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

January 12, 2023

7.3.0

Release 7.3.0

The Maps SDK for iOS version 7.3.0 is now available. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed.

If you are a new user, see Set up your Google Cloud project to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

Maps SDK framework installation with CocoaPods now includes built-in support for XCFramework. This framework allows developers to build code for Xcode Simulator on M1 Macs.

November 03, 2022

7.2.0

Release 7.2.0

The Maps SDK for iOS version 7.2.0 is now available. See the Release Notes for information about this release and for all previous releases or subscribe to the Release Notes XML feed.

If you are a new user, see Set Up in the Google Cloud Console to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

234007610 : Polyline spans fixed for paths with duplicate points on Metal.

August 29, 2022

7.1.0

Release 7.1.0

The Maps SDK for iOS version 7.1.0 is now available. See the Release Notes for information about this release and for all previous releases.

If you are a new user, see Set Up in the Google Cloud Console to start the installation process.

If you are an existing customer, see the upgrade instructions at Versions.

With this release, we have updated the default image used for markers in the Maps SDK for iOS.

239943840: Updated the draggable marker experience.

August 15, 2022

7.0.0

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 versionin your application's build dependencies in order to control when you raise the minimum supported OS for new versions of your app.

Version 7.0 - June 27, 2022

Support freezes

Version 6.2.1 - May 9, 2022

Bug fixes

Version 6.2.0 - April 25, 2022

Features

cloud-based maps stylinglets you style, customize, and manage your maps using the Google Cloud console. cloud-based maps styling is a paid feature accessed by adding amap ID to your app. The map ID triggers a map load charged against theDynamic 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

Bug fixes

Version 6.1.0 - March 9, 2022

Features

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 versionin 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 practiceswhich encourages specifying the newest version available in order to access the latest features and bugfixes.

Version 6.0.1 - December 9, 2021

Features

Version 6.0.0 - November 29, 2021

Features

Bug fixes

Support freezes

Support for cloud-based maps styling (paid feature) - October 27, 2021

Support for cloud-based maps stylingis generally available as of October 27, 2021 in SDK versions 5.0 and newer. These features, tied to a map ID, will incur charges against the Dynamic Maps SKU.

Version 5.2.0 - October 19, 2021

Features

Bug fixes

Known issues

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 versionin 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 onapp maintenance best practices.

Beta SDK deprecation - August 18, 2021

Deprecation

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:

For Android:

For iOS:

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 andiOS 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 Supportwith 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 versionin 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

Bug fixes

Support freezes

Version 5.0.0 - May 13, 2021

Support freezes

Deprecations

This release also includes deprecations and updates for thePlaces SDK for iOSand Navigation SDK for iOS.

Version 4.2.0 - March 8, 2021

Version 4.1.0 - December 8, 2020

Features:

Version 4.0.0 - October 13, 2020

Features:

Version 3.10.0 - August 10, 2020

Note:

Version 3.9.0 - May 26, 2020

Improvements

Bug fixes

Version 3.8.2 - May 18, 2020

Bug fixes

Version 3.8.0 - February 18, 2020

Note:

Version 3.7.0 - December 2, 2019

Version 3.6.0 - October 28, 2019

Version 3.5.0 - October 08, 2019

Resolved Issues:

Version 3.4.0 - September 04, 2019

Version 3.3.0 - July 29, 2019

Features

Resolved Issues

Version 3.2.0 - July 8, 2019

Resolved Issues:

Improvements:

Version 3.1.0 - April 16, 2019

Resolved Issues:

Version 3.0.0 - January, 2019

Known Issues:

Old Style Removed - November 1, 2018

Features:

New Style Default - June 28, 2018

Features:

NSArray *options = @[@"B3H9HE845CFHYG"];  
BOOL didSetApiOptions = [GMSServices provideAPIOptions:options];  
NSLog(@“Options were set: %d”, didSetApiOptions);

Version 2.7.0 - April 18, 2018

Improvements:

Resolved Issues:

Note:

New Style Opt-In - February 13, 2018

Features:

NSArray *options = @[@"B3MWHUG2MR0DQW"];  
BOOL didSetApiOptions = [GMSServices provideAPIOptions:options];  
NSLog(@“Options were set: %d”, didSetApiOptions);

Version 2.6.0 - February 6, 2018

Features:

Improvements:

Resolved Issues:

Note:

Version 2.5.0 - October 2017

Features:

Improvements:

Resolved Issues:

Version 2.4 - August 2, 2017

Resolved Issues

Version 2.3.1 - June 19, 2017

Resolved Issues

Version 2.3 - May 30, 2017

Improvements

Resolved Issues

Version 2.2 - February 14, 2017

Features

Improvements

Resolved Issues

Version 2.1.1 - November 8, 2016

Resolved Issues

Version 2.1 - September 22, 2016

Features

Resolved Issues

Version 2.0.1 - July 29, 2016

Resolved Issues

Version 2.0.0 - July 26, 2016

Improvements

Resolved Issues

Utility library update - July 19, 2016

Features

Version 1.13.2 - May 12, 2016

Resolved Issues

Version 1.13.1 - May 02, 2016

Resolved Issues

Version 1.13.0 - March 29, 2016

Features

Resolved Issues

Version 1.12.3 - February 2016

Resolved Issues

Version 1.12.2 - February 2016

Features

Resolved Issues

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

Resolved Issues

Version 1.11.0 - December 2015

Features

Resolved Issues

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

Resolved Issues

Version 1.10.4 - October 2015

Resolved Issues

Version 1.10.3 - September 2015

Features:

Resolved Issues:

Version 1.10.2 - August 2015

Resolved Issues:

Version 1.10.1 - June 2015

Resolved Issues:

Version 1.10.0 - May 2015

Features:

Resolved Issues:

Notes:

Migration from 1.9.2 or earlier:

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:

  1. Remove all references to the previous framework from your Xcode project.
  2. 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 theGoogle-Maps-iOS-SDK pod:

  1. Change your pod name to GoogleMaps.
  2. Run pod install.

Version 1.9.2 - February 2015

Download version 1.9.2.

Resolved Issues:

Version 1.9.1 - December 2014

Download version 1.9.1.

Resolved Issues:

Version 1.9.0 - October 2014

Download version 1.9.0.

Features:

Resolved Issues:

Notes:

Version 1.8.1 - May 2014

Download version 1.8.1.

Resolved issues:

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 issues:

Version 1.7.2 - March 2014

Download version 1.7.2.

Resolved issues:

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.

Resolved issues:

Version 1.7 - February 2014

Version 1.7 has been replaced by Version 1.7.2 and is no longer available for download.

Features

Resolved issues:

Notes:

Version 1.6.2 - January 2014

Download Version 1.6.2.

Resolved issues:

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 issues:

Version 1.6 - November 2013

Version 1.6 has been replaced by version 1.6.2 and is no longer available for download.

Features

Resolved issues:

Version 1.5 - September 2013

Download Version 1.5.

Features

Resolved issues:

Migration from 1.4.x:

  1. 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.
  2. The animated property of GMSMarker has been replaced with the new field:appearAnimation. To maintain previous behavior, replace all references to the animated property as follows:
marker.animated = YES;

Should be replaced with: 

marker.appearAnimation = kGMSMarkerAnimationPop;
  1. Changes to the GMSMarker.position property 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 issues:

Version 1.4.2 - August 2013

Resolved issues:

Version 1.4.1 - August 2013

Features

Resolved issues:

Version 1.4.0 - July 2013

Features

Resolved issues:

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:

  1. If your application relies on the accessibility elements of GMSMapView, set the accessibilityElementsHidden property to NO.
mapView_.accessibilityElementsHidden = NO;
  1. Replace direct references to the GMSGroundOverlay zoomLevel property 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

Resolved issues:

Version 1.3 - May 2013

Features

Resolved issues:

Version 1.2.2 - April 2013

Resolved issues:

Version 1.2 - April 2013

Features

Resolved issues:

Migration from 1.1.x:

When upgrading to the most recent version, you will have to modify any existing code as follows:

  1. Replace references to the width and stroke properties ofGMSPolyline with strokeWidth and strokeColor. The behavior is otherwise the same.
  2. Replace calls to the including method of GMSCoordinateBounds with a call to includingCoordinate.
  3. 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 GMSGroundOverlayOptions, GMSMarkerOptionsor GMSPolylineOptions.
    • GMSGroundOverlay, GMSMarker and GMSPolyline are now concrete classes, not protocols. Specify them as GMSMarker *, instead ofid<GMSMarker>.
    • Add an overlay to the map by setting its map property instead of calling the add...Overlay method.
    • Remove an overlay from the map by setting its map property to nil(rather than calling remove).
    • Values previously set on properties of an options object should now be set on the object itself.

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

Resolved issues:

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:

  1. In the Project Navigator, replace the previous framework with the most recent framework.
  2. Select your project from the Project Navigator, and choose your application's target.
  3. Open the Build Phases tab, and within Link Binary with Libraries:
    • Remove libstdc++.dylib.
    • Add libc++.dylib.
  4. Recompile your project.

Version 1.1.1 - March 2013

Features

Resolved issues:

Version 1.1 - February 2013

Features

Resolved issues:

Version 1.0.2 - January 2013

Features

Resolved issues:

Version 1.0.1 - December 2012