Fixed a memory leak by ensuring background executors are correctly cleaned up.
Added support for providing enhanced location context. When calling the Waypoint API, provide enhanced location context by specifying both a Place ID and latitude/longitude coordinates, or by using the navigationPointToken field. This context improves routing accuracy and the arrival experience, especially for large locations with multiple entrances or specific navigation points.
Improved voice guidance playback event sequencing to prevent overlapping instructions.
Fixed a crash on Android 10-12 devices caused by an incompatible URL encoding method.
Fixed a memory leak in NavigationView caused by an internal listener not being properly unregistered.
]]>setAudioGuidance can now be called at any point before navigation has started, as well as during active navigation.
Reduced visual noise during navigation by limiting the display of identical road labels and shields to three per viewport.
Updated the minimum Kotlin version to 2.2.10. Our recommended Android Gradle Plugin (AGP) is now 8.10.0 and Gradle is now 8.11.1.
For more information, see Kotlin version compatibility and migration.
]]>Fixed an issue that could cause the report incident button to not expand when navigation is started.
Road labeling during turn-by-turn navigation now uses the current route as context to declutter the map by automatically removing road labels for low-priority roads that do not intersect with the route. This feature is on by default.
In DRIVING mode, unpaved road callouts now appear on navigation routes in the USA, Canada, and Sweden.
Real-time disruption features are now in general availability (GA) generally available.
In DRIVING mode, narrow roads callouts now appear on navigation routes, where available.
Railroad crossing callouts now appear on navigation routes in the USA and Canada.
3D buildings (polygons with height) now appear during turn-by-turn navigation, where available. You can toggle this feature by using the GoogleMap.setBuildingsEnabled() method, which is set to true by default.
]]>Fixed a NoSuchElementException crash that occurred during navigation.
Fixed an ANR caused by a deadlock when triggering camera animations.
]]>The onGpsAvailabilityUpdate callback in the experimental GpsAvailabilityEnhancedLocationListener is now deprecated. Use onGpsAvailabilityChange instead.
Improved terms of service initialization to prevent ANR errors during NavSDK initialization.
Added a new callback, onGpsAvailabilityChange, to the experimental GpsAvailabilityEnhancedLocationListener, which provides changes to the internal GPS state. See GpsAvailabilityChangeEvent for more details.
Fixed an issue that resulted in ANR errors.
Improved terms of service processing to prevent timeouts leading to invalid TERMS_NOT_ACCEPTED errors.
]]>Improve performance around the NavigationApi.areTermsAccepted() API that was leading to ANR's on certain cases.
Fixed an issue that resulted in ANR errors.
Fixed an issue caused by a deadlock when Navigator.stopGuidance() was called that resulted in ANR errors.
Navigation voice guidance now references stop signs when describing upcoming maneuvers in the US, Japan, and Sweden.
]]>Updated setDestinations to return a DUPLICATE_WAYPOINTS_ERROR error if consecutive duplicate waypoints are set.
Updated road closures to display regardless of whether traffic prompts are enabled.
In accordance with the Mobile OS version support policy, we are freezing support for Android 7.0 and 7.1 (API level 24 and 25) in upcoming major versions of Navigation SDK for Android.
Added a proximity check for user-initiated voting during active navigation. To enhance map data quality, the Navigation SDK now checks whether a user-initiated vote on a real-time disruption was initiated near the incident.
Fix an issue in which the limit reached popup for reported incidents would not display until the next map initialization.
You can now use Cloud-based maps styling to style both the navigation map and the road map by creating reusable styles associated with Map IDs.
Fixed an issue with calls to getCurrentRouteSegment() that could cause incorrect waypoint values in the returned RouteSegment destinationWaypoint.
Removed the count of the number of users who have reported an incident from the incident callout.
Updated the minimum supported Android API Level from 23 to 24.
Added road closure callouts to alternate routes, in addition to the callouts on the current route.
The targetSdk is now API level 36. This will be a requirement for all apps that deploy to Google Play Store as of August 2025. See Meet Google Play's target API level requirement.
The DisplayOptions showTrafficLights and showStopSigns APIs are now deprecated and now default to true. These APis will be removed in the next major SDK release (8.0).
NavSDK API calls now throw specific NavSDK exceptions when invalid calls are made, replacing the previous general Maps API exceptions. This change can cause compilation errors if your app directly references Maps API exceptions. The new NavSDK exceptions still inherit from their corresponding Java Runtime exceptions.
Added javax.annotation.Nullable and androidx.annotation.Nullable annotations, which provide instructions for properly handling null pointers to avoid exceptions. For Java, these annotations are suggestions and do not require code changes if already handling potential null values. For Kotlin, you must properly use nullable types.
Updated the style and positioning of the compass in the navigation map
Removed the navigator.fetchRouteInfo() and com.google.android.libraries.navigation.RouteInfo APIs, as announced in the v6.0 release.
Fixed an issue that resulted in an ANR when the navigator is initializing in the main thread.
Fixed an issue that could cause the app to crash when the NavigationService is restarted in the background after a previous crash.
Fixed an issue that could cause the app to crash due to an uncaught ArithmeticException when the trip progress bar is displayed.
Fixed an issue that could cause the app to crash due to a NullPointerException when NavigationView.setTrafficIncidentCardsEnabled is called.
Fixed an issue that resulted in an ANR when starting guidance.
Fixed an issue that caused the camera to jump down when a user tapped or held on the screen while the camera was following the chevron. The camera now pauses and continues following the chevron when the user lifts their finger. If the user taps and drags, the camera will stop following the chevron.
Fixed an issue that could cause the app to crash due to a NullPointerException when NavigationView.setTrafficPromptsEnabled is called.
]]>Destination and entrance highlighting.
Added visual highlighting to destination buildings created with a placeID to aid users in distinguishing and navigating to their intended destination. For more information, see Destination highlighting and entrances.
Added the isIncidentReportingAvailable and showReportIncidentsPanel APIs to NavigationView and SupportNavigationFragment. These methods allow you to:
Check if incident reporting is available for the current navigation context.
Display the incident reporting panel programmatically, enabling you to implement custom incident reporting buttons.
For more information, see Add a custom reporting button.
Added route-relevant orientation landmark POIs. Landmark POIs, featuring visibly prominent chains, are now 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.
Updated the Trip Progress Bar position to better align with other Navigation UI elements.
Fixed visible prompts not being dismissed after setTrafficPromptsEnabled is disabled
Fixed an issue in landscape where turn card width was determined based on device screen size rather than the actual size of the map container, which caused problems in landscape mode in certain cases where the map container was not full width.
Fixed visible incident cards not being dismissed after setTrafficIncidentCardsEnabled is disabled
The Navigation SDK no longer intermittently causes application crashes (ANR: Input dispatching timed out) and deadlocks on various Android devices. See the public bug.
Added the ability to control the visibility of real-time disruption callouts using the setTrafficPromptsEnabled API. For more information, see Interactive disruption callouts along routes
Updated the Gradle project configuration validation. Starting with this SDK version, Gradle will checks the following project configurations:
Android Gradle Plugin minimum version
Desugar library enablement
Desugar library minimum version
If your implementation does not meet the minimum requirements, Gradle will return a compiler error starting with " An issue was found when checking AAR metadata: …". Any future changes to the requirements for these configurations will be included in the Navigation SDK release notes.
]]>Fixed an Application Not Responding (ANR) error caused by a deadlock occurring when navigation was stopped.
Fixed a NullPointerException that could occur due to a race condition when retrieving map styles for route callouts.
Fixed a race condition that occurred when polygons were simultaneously updated and added to the map.
Fixed ForegroundServiceDidNotStartInTimeException for Android S+ devices when the Navigation Service couldn't start due to incorrect dependency injection setup.
Fixed an issue that prevented marker info windows from showing up when programmatically requested shortly after marker creation.
]]>Fixed an issue that added extra padding to prompt layouts.
]]>Updated the size and position of the trip progress bar to provide an optimal experience for a larger range of devices.
Moved the Report Incident button 4 dp toward the edge of the map to better match other navigation UI elements.
Fixed an issue that caused the Report Incident panel to appear in Android Auto projections.
Updated traffic prompts to no longer incorporate map padding.To prevent collisions with prompts and UI elements outside of Nav SDK, adjust affected elements using a PromptVisibilityListener.
Fixed an issue that caused polylines to reappear after destinations had been cleared.
]]>Added configurable real-time disruptions features, which alert users about disruptions along their route and allow users to report and verify disruptions that they encounter.
For more information, see Configure real-time-disruptions.
Updated the default turn card header and footer designs to match the turn cards in the Google Maps app. Turn card height now adjusts dynamically to adapt to the text displayed in the card. You may want to update any existing custom headers to better match the new turn card style.
Added the Prompt Visibility API, helps you avoid conflicts between UI elements generated by the Navigation SDK and your own custom UI elements.
For more information see Prompt Visibility API (Experimental).
Fixed a bug that caused the Trip progress bar to be rendered incorrectly on tablets.
Fixed a bug in landscape where the camera viewport was incorrectly adjusted while a prompt was being displayed.
Moved the Trip progress bar to the start side (left side in LTR) of the screen.
Disabled the Trip progress bar for Android Auto.
Fixed a crash that was occurring after capturing a snapshot.
Updated the minimum Kotlin version to 2.1.
For more information, see Kotlin version compatibility and migration.
]]>Updated the map to include Road Level Details in select metropolitan areas worldwide. New details include crosswalks, sidewalks, and road lane markings. The areas where these elements are visible may vary over time.
Fix an issue that would cause apps that implement the Navigation SDK to crash and throw IncompatibleClassChangeError and ClassCastException errors.
]]>Navigation voice guidance now references traffic lights when describing upcoming maneuvers in US, CA, FR, NO and JP.
6.0.2Fixed an issue that could result in Java type check errors at runtime.
]]>The SDK now throws a ForegroundExpectedException from ForegroundServiceManager.startForeground(), instead of a RuntimeException, when the service can't be started in Foreground. This ForegroundExpectedException can be caught by apps that implement the SDK when ForegroundServiceManager.startForeground() is used.
Fixed an issue that would cause apps that implement the Navigation SDK to crash and throw a java.lang.IllegalStateException on the MediaPlayer.getDuration() method.
Updated the setCustomControl method to add support for a footer position. This fixes the issue of positioning custom control in relation to the ETA card.
For more information, see CustomControlPosition.FOOTER.
Enabled enforcement of the targetSdk increase to API level 34. This breaking change was announced in 6.0.0.
Re-enabled default jetification so that it no longer needs to be manually enabled in your project-level gradle.properties file.
This fixes an issue that would cause apps that implement the Navigation SDK to crash and throw a NoClassDefFound error.
Improved concurrency management within the SDK to address potential ANR errors caused by accessing artifacts from different threads.
Fixed an issue that resulted in an ANR error while inflating the SupportMapFragment.
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.
Fixed a race condition that was causing native crashes in certain situations for apps that use the Navigation SDK.
Fixed an issue that resulted in ANR errors while switching from Navigation to Map UI.
Updated the position of the compass in landscape mode. The compass now aligns with the top of the map, instead of the bottom of the header, in order to better accommodate the half-width header.
]]>Updated the setCustomControl method to add support for a footer position. This fixes the issue of positioning custom control in relation to the ETA card.
For more information, see CustomControlPosition.FOOTER.
Improved concurrency management within the SDK to address potential ANR errors caused by accessing artifacts from different threads.
Fixed an issue that would cause apps that implement the Navigation SDK to crash and throw a java.lang.IllegalStateException on the MediaPlayer.getDuration() method.
Fixed a race condition that was causing native crashes in certain situations for apps that use the Navigation SDK.
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.
Updated the position of the compass in landscape mode. The compass now aligns with the top of the map, instead of the bottom of the header, in order to better accommodate the half-width header.
Fixed an issue that resulted in an ANR error while inflating the SupportMapFragment.
Fixed an issue that would cause apps that implement the Navigation SDK to crash and throw a NoClassDefFound error due to a Jetification problem.
Fixed an issue that resulted in ANR errors while switching from Navigation to Map UI.
]]>Fixed an issue that would throw a SecurityException and cause the app to crash on devices running Android 14. This issue would occur if the app attempted to start a foreground service for guidance notifications without obtaining the users permission for background location access. For more information, see Background location usage.
]]>Updated the default camera bounds for 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.
Updated the setCustomControl method to add support for a footer position. This fixes the issue of positioning custom control in relation to the ETA card.
For more information, see Map UI Controls.
]]>Updated the position of the compass in landscape mode. The compass now aligns with the top of the map, instead of the bottom of the header, in order to better accommodate the half-width header.
Updated the position of custom control elements in landscape mode. Custom control elements in the BOTTOM_END_BELOW position now align with the bottom of the map, instead of the top of the footer, to better accommodate the half-width footer.
Fixed a race condition that was causing native crashes in certain situations for apps that use the Navigation SDK.
]]>Removed all of the ExternalCache methods and classes, which were deprecated in v5.0.
These include the following methods from GoogleMap model class, the following methods were removed:
GoogleMap#setExternalCacheGoogleMap#setNetworkEnabledGoogleMap#isNetworkEnabledThe following model classes were removed:
ExternalCacheResourceDescriptorTileDescriptorThe targetSdk is now API level 34. This will be a requirement for all apps that deploy to Google Play Store as of August 2024. See Meet Google Play's target API level requirement.
Starting with version 6.0.0 of the Navigation SDK for Android, apps must upgrade to Kotlin 2.0. For more information, see Migrate to Kotlin 2.0.
Removed the GoogleMap.addMarker(AdvancedMarkerOptions) method. This method was previously exposed because the Navigation SDK includes the Maps SDK API. However, the method was only included in the preview channel of the Maps SDK and was not used by the Navigation SDK. To add Markers or AdvancedMarkers to the map with the Nav SDK, use GoogleMap.addMarker(MarkerOptions) instead.
The use of MAP_TYPE_TERRAIN during navigation is deprecated.
Support for providing the Navigator with the same destination (waypoint) more than once consecutively has been deprecated. Note: The SDK does not currently throw an error in these cases.
Deprecated the navigator.fetchRouteInfo() method, which was previously only available to Mobility Services customers. Use the computeCustomRoutes() method from the Routes Preferred API instead.
In accordance with the Mobile OS version support policy, we are freezing support for Android 6 and 7 (API Level 23, 24, and 25) in upcoming major versions of Navigation SDK for Android.
Versions of Navigation SDK for Android released beginning the third quarter of 2025 will support a minimum of Android 8 (API Level 26). Earlier SDK versions will continue supporting Android 6 and 7.
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 Android 6 and 7.
Specify a version of the Navigation SDK for Android in your application's build dependencies in order to control when you raise the minimum supported OS for new versions of your app.
Removed default jetification from the Navigation. If your app relies on non-AndroidX libraries, set android.useAndroidX=true and android.enableJetifier=true in your project-level gradle.properties file. For more information, see the Navigation SDK sample app on GitHub.
An issue related to the use of earlier versions of desugaring libraries may cause some apps that implement the Navigation SDK to crash with the following NoSuchMethod error at runtime:
No virtual method toSeconds()J in class Ljava/time/Duration; or its super classes (declaration of 'java.time.Duration' appears in ...)
If you experience this issue, update your app to use com.android.tools:desugar_jdk_libs_nio:2.0.3 for desugaring. You may also need to upgrade to Gradle 8.4 and the Android Gradle plugin version 8.3.0. For more information, see Set up your Android Studio project or the Navigation SDK sample app on GitHub.
In the next major version of Navigation SDK, traffic lights and stop signs in DisplayOptions will be shown by default.
Updated the handling of quotas for destination requests to ensure quota tracking persists when an app is restarted.
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.
Fixed issues that could affect GPS accuracy and cause GPS error messages to appear during navigation.
5.99.0An issue related to AndroidX migration may cause some apps that implement the Navigation SDK to crash with the following NoClassDefFoundError error:
Fatal Exception: java.lang.NoClassDefFoundError: Failed resolution of: Landroid/support/v7/...
Fatal Exception: java.lang.NoClassDefFoundError: Failed resolution of: Landroid/support/v4/...
If you experience this issue, please use the following configuration in the project root gradle.properties file.
android.useAndroidX=true
android.enableJetifier=true
For more information, see the Navigation SDK sample app on GitHub.
Updated the handling of quotas for destination requests to ensure quota tracking persists when an app is restarted.
]]>Fixed a bug that prevented the Navigation SDK from executing native Java methods when the application was built on certain JDK versions.
Fixed an issue that caused an "application not responding" error when using R8 full mode.
]]>Fixed an issue that caused an "application not responding" error when using R8 full mode.
Updated the Terms and Conditions dialogue to show new text that covers new features being added to the product.
Updated the behavior of headers for the turn and ETA navigation cards that appear during turn-by-turn guidance. The headers now extend to only half of the screen width in landscape orientation in order to make more of the map visible.
Added the ability for developers to set the map color scheme to dark, light, or to use the system settings. For more information and examples, see Configure a map.
An issue related to the use of earlier versions of desugaring libraries may cause some apps that implement the Navigation SDK to crash with the following NoSuchMethod error at runtime:
No virtual method toSeconds()J in class Ljava/time/Duration; or its super classes (declaration of 'java.time.Duration' appears in ...)
If you experience this issue, update your app to use com.android.tools:desugar_jdk_libs_nio:2.0.3 for desugaring. You may also need to upgrade to Gradle 8.4 and the Android Gradle plugin version 8.3.0. For more information, see Set up your Android Studio project or the Navigation SDK sample app on GitHub.
Made improvements to rendering performance during guidance.
Added additional triggers for RouteChangedListener after a route is generated, after the driver selects an alternative route (before starting navigation), and after a route is cleared.
Fixed an issue that would throw a NullPointerException when calling NavigationTransactionRecorder.getTransactionRecorder() if Project Properties were not yet available.
Fixed an issue that would throw a TransactionException when calling Navigator.setTransactionIds() if Project Properties were not yet available.
Fixed an issue that would throw TransactionException errors stating a project was not allowed to use the setTransactionIds() API.
]]>Fixed an issue that caused a NullPointerException when using R8 full mode.
Fixed an issue that would throw a SecurityException and cause the app to crash on devices running Android 14. This issue would occur if the app attempted to start a foreground service for guidance notifications without obtaining the users permission for background location access. For more information, see Background location usage.
]]>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.3.0 and higher. For more information, see Traffic lights or stop sign icons.
]]>Fixed an issue where users of the Android Gradle Plugin < 7.3.0 would experience bugs associated with JDK-8272564, such as NPE, java.lang.ExceptionInInitializerError, and java.lang.IncompatibleClassChangeError.
Fixed an issue where apps using targetSDK 34 would throw a SecurityException. For more information about declaring new permission to use foreground service types in Android, see https://developer.android.com/about/versions/14/changes/fgs-types-required#permission-for-fgs-type .
]]>Fixed an issue where apps using targetSDK 34 would throw a SecurityException. For more information about declaring new permission to use foreground service types in Android, see https://developer.android.com/about/versions/14/changes/fgs-types-required#permission-for-fgs-type.
Fixed a bug that caused NullPointerException errors to be thrown arbitrarily within apps using the Navigation SDK.
Fixed an issue where users of Android Gradle Plugin < 7.3.0 would experience bugs associated with JDK-8272564, such as NPE, java.lang.ExceptionInInitializerError, and java.lang.IncompatibleClassChangeError.
]]>Fixed memory leaks that occurred after guidance has started.
Fixed a bug that caused NullPointerException errors to be thrown arbitrarily within apps using the Navigation SDK.
Reduced initialization latency of the Navigation SDK.
Fixed a demo app memory leak by using attach/detach in place of replace for swapping fragments.
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.
Added an example of how to work around an Android 12 PermissionUsageHelper leak in the demo app.
]]>