Improved arrival triggering for more accurate detection and a more consistent experience when reaching a destination.
Updated the desugaring configuration to require desugar_jdk_libs_nio.
Fixed the issue that could trigger the IllegalArgumentException: Service not registered error under certain conditions.
Fixed a bug where disputed borders were not displaying correctly in certain countries.
Reduced the startup latency of the Navigation SDK.
Fixed a bug where a traffic incident card changed the position of other UI elements instead of being displayed on top of them as a modal UI element.
Fixed a bug where the recenter button isn't dismissed and the camera doesn't zoom in to the current location after arrival.
]]>Fixed a memory leak in NavigationView caused by an internal listener not being properly unregistered.
Fixed a crash on Android 10-12 devices caused by an incompatible URL encoding method.
Improved voice guidance playback event sequencing to prevent overlapping instructions.
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.
Fixed a memory leak by ensuring background executors are correctly cleaned up.
]]>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.
Reduced visual noise during navigation by limiting the display of identical road labels and shields to three per viewport.
setAudioGuidance can now be called at any point before navigation has started, as well as during active navigation.
]]>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.
Railroad crossing callouts now appear on navigation routes in the USA and Canada.
Added a new dependency on Jetpack Datastore. This change is handled by the Navigation SDK and doesn't require any action by developers or changes to apps that use the SDK, except in cases where an app is already using a non-compatible version of the library.
In DRIVING mode, narrow roads callouts now appear on navigation routes, where available.
Real-time disruption features are now in general availability (GA) generally available.
The height of the Trip Progress Bar now adjusts dynamically to prevent overlap with other elements on the screen.The element disappears when its height falls below a minimum threshold and doesn't expand beyond a maximum threshold.
In DRIVING mode, unpaved road callouts now appear on navigation routes in the USA, Canada, and Sweden.
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.
Fixed an issue that could cause the report incident button to not expand when navigation is started.
]]>Fixed an ANR caused by a deadlock when triggering camera animations.
Fixed a NoSuchElementException crash that occurred during navigation.
]]>Improved terms of service processing to prevent timeouts leading to invalid TERMS_NOT_ACCEPTED errors.
Fixed an issue that resulted in ANR errors.
Added a new callback, onGpsAvailabilityChange, to the experimental GpsAvailabilityEnhancedLocationListener, which provides changes to the internal GPS state. See GpsAvailabilityChangeEvent for more details.
Improved terms of service initialization to prevent ANR errors during NavSDK initialization.
The onGpsAvailabilityUpdate callback in the experimental GpsAvailabilityEnhancedLocationListener is now deprecated. Use onGpsAvailabilityChange instead.
]]>Fixed an issue caused by a deadlock when Navigator.stopGuidance() was called that resulted in ANR errors.
Fixed an issue that resulted in ANR errors.
Improve performance around the NavigationApi.areTermsAccepted() API that was leading to ANR's on certain cases.
Navigation voice guidance now references stop signs when describing upcoming maneuvers in the US, Japan, and Sweden.
]]>Removed the navigator.fetchRouteInfo() and com.google.android.libraries.navigation.RouteInfo APIs, as announced in the v6.0 release.
Updated the style and positioning of the compass in the navigation map
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.
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.
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).
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.
Added road closure callouts to alternate routes, in addition to the callouts on the current route.
Updated the minimum supported Android API Level from 23 to 24.
Removed the count of the number of users who have reported an incident from the incident callout.
Fixed an issue with calls to getCurrentRouteSegment() that could cause incorrect waypoint values in the returned RouteSegment destinationWaypoint.
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.
Added a new dependency on the fastutil library. This change is handled by the Navigation SDK and doesn't require any action by developers or changes to apps that use the SDK, except in cases where an app is already using a non-compatible version of the library.
Fix an issue in which the limit reached popup for reported incidents would not display until the next map initialization.
Removed library desugaring from Navigation SDK. You must update your app to use com.android.tools:desugar_jdk_libs_nio:2.0.3 for desugaring. We also recommend that you upgrade to Gradle 8.11.1 and the Android Gradle plugin version 8.10.0. For more information, see Set up your Android Studio project or the Navigation SDK sample app on GitHub.
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.
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.
Updated road closures to display regardless of whether traffic prompts are enabled.
Updated setDestinations to return a DUPLICATE_WAYPOINTS_ERROR error if consecutive duplicate waypoints are set.
]]>Fixed an issue that could cause the app to crash due to a NullPointerException when NavigationView.setTrafficPromptsEnabled is called.
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 resulted in an ANR when starting guidance.
Fixed an issue that could cause the app to crash due to a NullPointerException when NavigationView.setTrafficIncidentCardsEnabled is called.
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 when the NavigationService is restarted in the background after a previous crash.
Fixed an issue that resulted in an ANR when the navigator is initializing in the main thread.
]]>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.
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.
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.
The Navigation SDK no longer intermittently causes application crashes (ANR: Input dispatching timed out) and deadlocks on various Android devices. See the public bug.
Fixed visible incident cards not being dismissed after setTrafficIncidentCardsEnabled 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 prompts not being dismissed after setTrafficPromptsEnabled is disabled
Updated the Trip Progress Bar position to better align with other Navigation UI elements.
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.
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
]]>Fixed an issue that prevented marker info windows from showing up when programmatically requested shortly after marker creation.
Fixed ForegroundServiceDidNotStartInTimeException for Android S+ devices when the Navigation Service couldn't start due to incorrect dependency injection setup.
Fixed a race condition that occurred when polygons were simultaneously updated and added to the map.
Fixed a NullPointerException that could occur due to a race condition when retrieving map styles for route callouts.
Fixed an Application Not Responding (ANR) error caused by a deadlock occurring when navigation was stopped.
]]>Fixed an issue that added extra padding to prompt layouts.
]]>Moved the Report Incident button 4 dp toward the edge of the map to better match other navigation UI elements.
Updated the size and position of the trip progress bar to provide an optimal experience for a larger range of devices.
Fixed an issue that caused polylines to reappear after destinations had been cleared.
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 the Report Incident panel to appear in Android Auto projections.
]]>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).
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 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 minimum Kotlin version to 2.1.
For more information, see Kotlin version compatibility and migration.
Fixed a crash that was occurring after capturing a snapshot.
Disabled the Trip progress bar for Android Auto.
Moved the Trip progress bar to the start side (left side in LTR) of the screen.
Fixed a bug in landscape where the camera viewport was incorrectly adjusted while a prompt was being displayed.
Fixed a bug that caused the Trip progress bar to be rendered incorrectly on tablets.
]]>Fix an issue that would cause apps that implement the Navigation SDK to crash and throw IncompatibleClassChangeError and ClassCastException errors.
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.
]]>Fixed an issue that could result in Java type check errors at runtime.
All versionsNavigation voice guidance now references traffic lights when describing upcoming maneuvers in US, CA, FR, NO and JP.
]]>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.
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.
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.
Enabled enforcement of the targetSdk increase to API level 34. This breaking change was announced in 6.0.0.
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 ANR errors while switching from Navigation to Map UI.
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.
Fixed an issue that resulted in an ANR error while inflating the SupportMapFragment.
Improved concurrency management within the SDK to address potential ANR errors caused by accessing artifacts from different threads.
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.
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.
Fixed an issue that resulted in ANR errors while switching from Navigation to Map UI.
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 an ANR error while inflating the SupportMapFragment.
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 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 would cause apps that implement the Navigation SDK to crash and throw a java.lang.IllegalStateException on the MediaPlayer.getDuration() method.
Improved concurrency management within the SDK to address potential ANR errors caused by accessing artifacts from different threads.
]]>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 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 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.
]]>Fixed a race condition that was causing native crashes in certain situations for apps that use the Navigation SDK.
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.
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.
]]>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.
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.
The 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.
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:
ExternalCacheResourceDescriptorTileDescriptorDeprecated the navigator.fetchRouteInfo() method, which was previously only available to Mobility Services customers. Use the computeCustomRoutes() method from the Routes Preferred API instead.
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.
The use of MAP_TYPE_TERRAIN during navigation is deprecated.
In the next major version of Navigation SDK, traffic lights and stop signs in DisplayOptions will be shown by default.
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.
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.
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.
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.
Updated the handling of quotas for destination requests to ensure quota tracking persists when an app is restarted.
Fixed issues that could affect GPS accuracy and cause GPS error messages to appear during navigation.
5.99.0Updated the handling of quotas for destination requests to ensure quota tracking persists when an app is restarted.
An 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.
]]>Fixed an issue that caused an "application not responding" error when using R8 full mode.
Fixed a bug that prevented the Navigation SDK from executing native Java methods when the application was built on certain JDK versions.
]]>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.
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.
Updated the Terms and Conditions dialogue to show new text that covers new features being added to the product.
Fixed an issue that caused an "application not responding" error when using R8 full mode.
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.
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.
Made improvements to rendering performance during guidance.
Fixed an issue that would throw TransactionException errors stating a project was not allowed to use the setTransactionIds() API.
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 a NullPointerException when calling NavigationTransactionRecorder.getTransactionRecorder() if Project Properties were not yet available.
]]>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.
Fixed an issue that caused a NullPointerException when using R8 full mode.
]]>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 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 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 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 a bug that caused NullPointerException errors to be thrown arbitrarily within apps using the Navigation SDK.
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.
]]>