For major releases (for example, 10.0.0), expect a major feature or features, additional smaller features and bug fixes, backwards incompatibility with the previous version, and dependency upgrade requirements.
For minor releases (for example, 9.2.0), expect minor features and bug fixes, backwards compatibility with the previous version, and minor version upgrades of a dependency.
For patch releases (for example, 9.2.1), expect bug fixes, backwards compatibility with the previous version, and patch upgrades of a dependency.
Dependencies and requirementsThe table below shows the dependencies and requirements for the latest version of the Navigation SDK for iOS.
SDK version Minimum iOS deployment target Minimum Xcode version 10.0 16.0 16.x.x August 12, 202510.2.0
The Navigation SDK for iOS version 10.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 Overview and requirements.
10.2.0
3D buildings display during navigation. Displays 3D buildings (polygons with height) during turn-by-turn navigation. You can toggle this feature by using the Maps SDK buildingsEnabled: method. See the documentation.
10.2.0
Proximity check added for user-initiated voting mid-trip. To enhance map data quality, the Navigation SDK for iOS now checks whether a user-initiated vote on a real-time disruption was initiated near the incident.
10.2.0
Voice guidance messages now can include distance.
10.2.0
The number of users who have reported an incident no longer appears in the incident callout.
10.2.0
The real-time disruptions button is not re-enabled if disabled programmatically when the reporting panel is dismissed.
10.2.0
The setDestinations() methods now reset the traveledPath property.
10.2.0
Info window information now appears in large text view.
July 14, 202510.1.0
The Navigation SDK for iOS version 10.1.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 Overview and requirements.
10.1.0
showsTrafficLights and showsStopSigns are deprecated and will be removed in a future release.
10.1.0
Custom buttons for real-time disruptions.
You can now create custom buttons to initiate the real-time disruptions (RTD) reporting flow.
The new reportIncidentsAvailable and presentReportIncidentsPanel methods have been added to the GMSMapView class. These methods allow you to:
10.1.0
Maneuver callouts enabled. Callouts now appear before the next maneuver(s) that a user needs to make, not at the moment they need to make the maneuver.
10.1.0
Slowdown and stalled vehicle callouts disabled. Callouts now do not appear for slowdowns and stalled vehicles, and users are no longer able to vote or report on stalled vehicle incidents. This creates a more streamlined experience.
10.1.0
Added the ability to control the visibility of real-time disruption callouts using the shouldDisplayPrompts method. For more information, see Interactive disruption callouts along routes.
10.1.0
Fixed: Issue where background notifications were not replaced.
10.1.0
Fixed: The corner radius of the ETA card has been adjusted to match other Google UI elements.
10.1.0
Fixed: The real-time disruption button now moves vertically when mapPadding is added.
10.0.0
The Navigation 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 your Google Cloud project to start the installation process. If you are an existing customer, see the upgrade instructions at Overview and requirements.
10.0.0
According to the Mobile OS version support policy, we are freezing support for iOS 15 as of Navigation 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 Navigation 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.
10.0.0
The showsTrafficLights and showsStopSigns properties in GMSUISettings are now deprecated. Traffic lights and stop signs will be shown along the route during navigation by default, when the data is available.
10.0.0
In the next major version of Navigation SDK, compassButton in GMSUISettings will be shown by default.
10.0.0
In the next major version of Navigation SDK, traffic lights and stop signs in GMSUISettings will be shown by default.
10.0.0
Destination and entrance highlighting. When a destination is created with a placeID, the destination building will now be highlighted and an entrance icon will be shown whenever possible. These visual cues aid users in distinguishing and navigating to their intended destination. See the documentation.
10.0.0
Route-relevant orientation landmark POIs. Landmark POIs, featuring visibly prominent chains, are displayed by default along routes and near key intersections where maneuvers are required. These pins appear in both the route overview and during active navigation. This feature is on by default.
10.0.0
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.
10.0.0
The new minimum version of Xcode is 16.0.
March 24, 20259.4.0
9.4.0
Enable and configure real-time disruption features. Real-time disruptions are a collection of features that alert users about disruptions along their route and allow users to report and verify disruptions that they encounter. Real-time disruption features are enabled for all customers by default, but can be disabled. All drivers who haven't accepted the in-app terms from Navigation SDK for iOS v9.1.0 or later will be prompted to accept them in this release to provide awareness of the disruption reporting. See the full documentation.
9.4.0
Trip Progress Bar
9.4.0
The compass and Google logo are now mirrored for right-to-left languages. The compass is on the left and the logo is on the right for right-to-left languages.
9.4.0
Updated the default camera bounds in landscape mode. Camera bounds are now centered in the end half (right half in left-to-right layouts) of the screen to provide more space around the chevron.
February 04, 2025All versions
Navigation voice guidance now references traffic lights when describing upcoming maneuvers in US, CA, FR, NO and JP.
January 27, 20259.3.0
9.3.0
Swift Preview no longer breaks when the Navigation SDK for iOS and Maps SDK for iOS are added using Swift Package Manager.
9.3.0
If you are creating a purely Objective-C project, you must also create an empty .swift file in your project, or add the following into the Other Linker Flags section of the Xcode project: - L$(DEVELOPER_DIR)/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift/$(PLATFORM_NAME)
9.3.0
As of this release, crosswalks, sidewalks, and road lane markings may be visible on the map in certain metropolitan areas worldwide. 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.
November 18, 20249.2.0
9.2.0
New navigation component colors. Updated all the navigation component colors on 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.
9.2.0
All GoogleMapsBase references are now part of GoogleMaps. GoogleMaps.xcframework now includes GoogleMapsBase and GoogleMapsCore. Any configuration references to either framework can be removed.
9.2.0
Updated API reference. The look and organization of the Navigation SDK for iOS 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.
September 19, 20249.1.2
Bug fixes.
August 28, 20249.1.1
Bug fixes.
9.1.1
Export the classes GMSNavigationLane, GMSNavigationLaneDirection, and GMSNavigationTermsAndConditionsOptions.
9.1.0
The Navigation SDK for iOS version 9.1.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 Overview and requirements.
9.1.0
This release introduces a new Skip Terms of Service Options API.
This is a new GMSNavigtionTermsAndConditionsOptions API to present the terms and conditions dialog. Developers are recommended to use GMSNavigationServices.showTermsAndConditionsDialogIfNeededWithOptions:callback: to present the dialog.
9.1.0
Fixed a bug where the wrong maneuver icon was sometimes displayed.
9.1.0
Fixed a bug where GMSNavigationNavInfo was not always reported when navigation is stopped.
9.1.0
Fixed a bug where the reported GMSNavigationNavState could be incorrect when a reroute is about to occur.
9.0.0
Release 9.0.0
New Features. The navigation SDK for iOS now offers updated map colors, CarPlay support, and updated default turn card design.
The version numbering for Navigation SDK for iOS is advancing from v4.x to v9 to match the version numbers of the Maps and Places SDKs for iOS.
9.0.0
iOS version support. 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.
9.0.0
New map colors. 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.
9.0.0
CarPlay: The Navigation SDK for iOS now allows developers to support Apple's CarPlay feature. You can display your app's navigation experience on in-dash head units, and drivers can use your app directly by connecting their iPhone to the unit. Voice guidance can also run on the car's speakers. See Enable navigation for CarPlay for more information.
9.0.0
Updated headers: The default turn card header and footer designs are updated to match the new turn cards that are already available in the Google Maps app. Developers may wish to refresh the design of any custom headers to better match the new rounded-corner look.
9.0.0
Privacy manifest: The Apple Privacy Manifest file is now included in the resources bundle for the SDK. For more information, see Inspect Apple privacy manifest file.
9.0.0
The terms and conditions dialog no longer has a decline button. Drivers must acknowledge the terms and conditions from the dialog in order to continue using navigation.
9.0.0
In order to provide a safer environment for drivers, terrain mode during active navigation in the Navigation SDK for iOS is deprecated as of 9.0, and will be unsupported in the major version that will be released in the second quarter of 2025.
Instead, normal mode will be displayed.
9.0.0
The cancelButtonTextColor property in GMSNavigationTermsDialogUIParams is now deprecated.
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.
4.1.0
Traffic lights and stop sign icons along the route are now supported in JP, GB, and DE, in addition to BE, CA, ES, FR, IT, NL, SE, US. This change is available in SDK versions 4.1.0 and higher. For more information, see Traffic lights or stop sign icons.
April 25, 20245.3.0
The Cloud-based maps styling in the Navigation SDK does not support map styling in navigation when GMSMapView.navigationEnabled is set.
5.4.0
With the release of the Places SDK for iOS version 8.5, the latest version of the Nav SDK for iOS remains v.5.4.0.
5.4.0
The new minimum supported version of Xcode is 15.0.
February 06, 20245.4.0
The driven part of the route polyline is now updated to be gray.
December 14, 20235.3.1
Release 5.3.1
Infrastructure update. The Navigation 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 Navigation 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 Navigation SDK for iOS to a project through Swift Package Manager, see the Set up your project guide.
November 22, 20235.3.0
Release 5.3.0
The Navigation SDK for iOS version 5.3.0 is now available. For information about this release, and for all previous releases, see the Release notes or subscribe to the release notes XML feed.
If you are a new user, see Set up your project to get started.
5.3.0
Cloud-based styling is now supported for Navigation SDK versions 5.3.0 and higher. For information on cloud-based styling, see the New Cloud Styling Overview.
5.3.0
Data-driven styling is now supported for Navigation SDK versions 5.3.0 and higher. For information on data-driven styling, see Data-driven styling for boundaries.
5.3.0
Advanced markers are now supported for Navigation SDK versions 5.3.0 and higher. For information on advanced markers, see Advanced Markers Overview.
September 19, 20235.2.0
Release 5.2.0
The Navigation SDK for iOS version 5.2.0 is now available. For information about this release, and for all previous releases, see the Release notes or subscribe to the release notes XML feed.
If you are a new user, see Set up your project to get started.
5.2.0
Fixes a bug in which navigation stops when there is no internet connection.
July 24, 20235.1.0
Fixes a bug in which some arrival notifications were empty. Now, arrival notifications send the waypoint title.
May 17, 20235.0.0
The navigationMapStyle API and the GMSNavigationMapStyle enumerator is removed. Deprecation announcement was released on Aug 29th 2022.
5.0.0
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.
5.0.0
The TurnByTurn roundaboutTurnNumber now returns the maneuver number instead of the degree radius of the turn.
5.0.0
Introduces a new class GMSNavigatorSession which can be created from a new class method on GMSNavigationServices and then used to programmatically control a navigation session.
5.0.0
You can now set 25 waypoints as maximum destinations. Providing more than 25 waypoints will get a GMSRouteStatusWaypointError error code.
5.0.0
The new minimum supported version of Xcode is 14.0. Note the deprecations in the Xcode 14 release notes about the end of support for building with bitcode.
May 15, 20234.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 Navigation SDK for iOS.
Versions of 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 Navigation 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, 20234.4.0
The Navigation SDK for iOS version 4.4.0 is now available. Version bump, no changes. This version is functionally identical to v.4.3.0. See the Release Notes for information about this release and for all previous releases, or subscribe to the Release Notes XML feed.
4.4.0
Navigation SDK for iOS is now available as a CocoaPods pod. See Set up your project in the SDK documentation to learn more.
4.4.0
If your project must show the Terms and Conditions dialog, setting shouldOnlyShowDriverAwarenesssDisclaimer to YES has no effect.
4.3.0
257934849: Fixes a bug where a map's custom style disappears if navigation is enabled and subsequently disabled in the map view.
November 03, 20224.2.0
The Terms of Service dialogue shows updated language.
4.2.0
243163913: Fixes a crash when displaying the Terms of Service dialog on the mobile device while connected to CarPlay. (Note: CarPlay is not yet supported in Navigation SDK)
August 29, 20224.1.0
Allow customers to show traffic lights and stop signs during navigation.
4.1.0
Deprecates the GMSNavigationMapStyle API and the GMSNavigationMapStyleDefault and GMSNavigationMapStyleHighDetail enumerators. These enumerators enabled you to switch your app's default map view from a simple base map style to a detailed map style showing extra detailed tiles, including 2D building outlines on zoom level 18+ and 2D building numbers on zoom level 19+. Due to changes in the base map for iOS, these details are now enabled by default, so this enumerator is no longer necessary.
Features
Features
Features
Bug fixes
Features
You can now add a trip progress bar to display the details of the trip in a linear view on the trailing edge of the map. Enable it by setting the new navigationTripProgressBarEnabled property in GMSUISettings.
You can now subscribe to navigation state information (including step info, ETA, and remaining distance) through the didUpdateNaveInfo: event listener in GMSNavigatorListener. See Building TurnByTurn navigation on small external screens.
Bug fixes
Bug fixes Previous versions failed to launch for apps developed with SceneDelegate because the Terms of Service dialog did not display. Now, scene-based apps should correctly display the Terms of Service dialog and the app will launch after user acknowledgement.
Bug fixes
Features
Features
Alternative map types, including Satellite, Terrain, and Hybrid maps, are now supported in navigation mode.
(Beta) This release contains a preview of support for the XCFramework format. You can now install the Navigation 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 .framework version of the SDK for your production apps.
Support for iOS 11 is now frozen. The minimum iOS version is now 12.0.
The new minimum version of Xcode is 12.0.
Features
In response to changes in our internal dependencies, we are freezing support for iOS 12 in an upcoming major version of Google Maps Platform SDKs for iOS.
Navigation SDK for iOS v4.0 or higher will only support devices running a minimum of iOS 13.
Apps built with v3.x of the Maps SDK for iOS will continue to work for iOS 12. If your dependencies in CocoaPods or Carthage don't specify a version number, Xcode will load the newest version and new builds of your app won't support iOS 12.
Steps to take
pod outdated or carthage outdated to check for new versions of your CocoaPods or Carthage dependencies. See the guidance on app maintenance best practices. Don't upgrade to v4.0 or higher for Navigation SDK for iOS until you are ready to drop support of iOS 12 for your app.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. Earlier SDK versions will continue supporting iOS 11.
The following SDK versions will only support devices running a minimum of iOS 12:
Apps built with v5.x of the Maps and Places SDKs for iOS and v2.x of the Navigation SDK will continue to work for iOS 11. If your dependencies in CocoaPods or Carthage don't specify a version number, Xcode will load the newest version and new builds of your app won't support iOS 11.
Steps to take
pod outdated or carthage outdated to check for new versions of your CocoaPods or Carthage dependencies. See the guidance on app maintenance best practices. Don't upgrade to v6.0 or higher for Maps and Places SDKs, or v3.0 or higher for Navigation SDK, until you are ready to drop support of iOS 11 for your app.Features
followingZoomLevel now takes effect immediately in following mode; after starting a new navigation session, the camera does not zoom out.setTransactionIDs:errorHandler method in GMSNavigator. Use this method to set the ongoing transaction IDs which apply to the navigation events during the current navigation session.Decommissions
The deprecated GMSNavigatorDelegate and GMSRoadSnappedLocationProviderDelegate protocols will change the protocol names to GMSNavigatorListener and GMSRoadSnappedLocationProviderListener, respectively. All previous delegate methods will exist in the new listeners, with the following exceptions.
GMSNavigator and GMSRoadSnappedLocationProvider removed the deprecated property delegate. Instead, call methods -addListener: and -removeListener, respectively, to add or remove the replacement listeners.
GMSNavigatorDelegate methods - (NSTimeInterval)navigatorTimeUpdateThreshold:(GMSNavigator *)navigator and - (CLLocationDistance)navigatorDistanceUpdateThreshold:(GMSNavigator *)navigator are removed. Instead, set the timeUpdateThreshold and distanceUpdateThreshold properties on GMSNavigator directly.
GooglePlaces.framework won't be included in the Navigation SDK for iOS Zip package in the next Navigation SDK release. If you need the Places SDK in your application, follow the Places SDK for iOS installation instructions.
Features:
navigationMapStyle property to the GMSUISettings class. The map will display 2D building outlines at zoom level 18+ when this property is set to GMSNavigationMapStyleHighDetail.followingZoomLevel property to the GMSMapView class. You can use this property to set the zoom level when the camera is in following mode during navigation.stopGuidanceAtArrival property to the GMSNavigator class. You can use this property to determine whether guidance should automatically stop when navigator:didArriveAtWaypoint: is called.Bug fixes:
Bug fixes:
GMSNavigationCameraModeFree if set to GMSNavigationCameraModeFollowing.Features:
Features:
setAbnormalTerminationReportingEnabled: API on GMSNavigationServices.Features:
vehicleStopover property to the GMSNavigationWaypoint class. This feature relocates the waypoint to a nearby place if its location is not suitable for a vehicle to make a stop.GMSNavigationMutableWaypoint which lets you change some waypoint properties.GMSNavigatorListener and GMSRoadSnappedLocationProviderListener protocols, which enable multiple classes to listen to important navigation and road snapping events.Deprecations
GMSNavigatorDelegate and GMSRoadSnappedLocationProviderDelegate protocols are deprecated as of August 24, 2020. Instead, use GMSNavigatorListener and GMSRoadSnappedLocationProviderListener.Note:
Features:
routingOptions using the initWithTargetDistancesMeters (GMSNavigationRoutingOptions.h), and then call setDistinations (GMSNavigator.h), passing the routing options.Note:
Features:
Drivers can now receive speed alerts when they exceed speed limits. Speed alerts are enabled through shouldDisplaySpeedometer and configurable through GMSNavigationSpeedAlertOptions and GMSNavigationSpeedometerUIOptions.
Stability and Bug fixes
Features:
alternateRoutesStrategy to GMSNavigationRoutingOptions. This lets the user select the number of alternate routes shown.routingStrategy to GMSNavigationRoutingOptions. This allows the returned routes to be ordered by either time or distance.Stability and Bug fixes
Stability and Bug fixes
Features:
TWO-WHEELER to get motorcycle and scooter routes. This feature is only available in India and Indonesia.Stability and Bug fixes
Features:
Taxi mode - BETA: Your app can use the lanes and streets that are specifically dedicated to taxicabs to provide routing and Estimated Time of Arrival (ETA)s for vehicles identified as taxicabs.
The following geographical areas are supported:
Spain: Madrid, Barcelona
Traffic status: Your app can report the level of congestion along a route using the getSeverity method of the TimeAndDistance class.
Features:
Known issues
The new basemap style has been enabled by default in the Maps SDK for iOS, however it is NOT enabled for Nav SDK users. Compiling the Nav SDK and Maps SDK together will cause your project to be opted out of the new basemap style. Therefore, contrary to the instructions for the Maps SDK, Nav SDK users will need to explicitly opt-in.
To opt-in, use the code snippet below. The best place to do this in your app is right after providing your API key, using GMSServices provideAPIKey. You must be using at least Version 1.6 in order to opt-in.
NSArray *options = @[@"B3MWHUG2MR0DQW"];
BOOL didSetApiOptions = [GMSServices provideAPIOptions:options];
NSLog(@"Options were set: %d", didSetApiOptions);
Stability and Bug fixes
Major Dependency Updates
Known issues
Stability and Bug fixes
Major Dependency Updates
Stability and Bug fixes
Known issues
Bug fixes and improvements.
This version is functionally identical to v1.3.
Version 1.3.2 (Jan 23, 2017)Added a mitigation for Open GL crashes with stack traces containing gmscore::renderer::ios::GLRenderTarget::FrameEnd() where the process is killed by SIGABRT. This change is expected to reduce the rate of these crashes but not fix them completely. The underlying issue is believed to be in Apple's Open GL implementation.
Changed the build process for the frameworks to stop using the -bitcode_hide_symbols flag in the prelinking stage. This causes non-exported symbols to be included in the bitcode bundle which may allow app stack traces to be symbolicated to a greater extent.
This version is functionally identical to v1.3.
Version 1.3 (November 6, 2017)Features:
Resolved Issues:
Resolved Issues:
Features:
audioDeviceType property on GMSNavigator.Resolved Issues:
navigationFooterEnabled property to NO sometimes didn't work.Launch of the Navigation SDK for iOS.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4