Merge pull request #301 from heremaps/esd/41730

Update example apps for release 4.17.3.0

Author: maharudraabhishek

README.md

@@ -26,7 +26,7 @@ For an overview of the existing features, please check the _Developer Guide_ for
 
 > For now, the _Navigate Edition_ is only available upon request. Please contact your HERE representative to receive access including a set of evaluation credentials.
 
-## List of Available Example Apps (Version 4.17.2.0)
+## List of Available Example Apps (Version 4.17.3.0)
 
 - **HelloMap**: Shows the classic 'Hello World'.
 - **HelloMapKotlin**: Shows the classic 'Hello World' using Kotlin language (Android only).

examples/latest/README.md

@@ -1,4 +1,4 @@
-This folder contains the HERE SDK examples apps for version: 4.17.2.0
+This folder contains the HERE SDK examples apps for version: 4.17.3.0
 
 - HERE SDK for Android ([Lite Edition](lite/android/), [Explore Edition](explore/android/), [Navigate Edition](navigate/android/))
 - HERE SDK for iOS ([Lite Edition](lite/ios/), [Explore Edition](explore/ios/), [Navigate Edition](navigate/ios/))

examples/latest/navigate/android/Navigation/app/src/main/java/com/here/navigation/App.java

@@ -63,6 +63,7 @@ public class App {
     private final RouteCalculator routeCalculator;
     private final NavigationExample navigationExample;
     private final TextView messageView;
+    private boolean isCameraTrackingEnabled = true;
 
     public App(Context context, MapView mapView, TextView messageView) {
         this.context = context;
@@ -102,10 +103,12 @@ public void clearMapButtonPressed() {
     public void toggleTrackingButtonOnClicked() {
         // By default, this is enabled.
         navigationExample.startCameraTracking();
+        isCameraTrackingEnabled = true;
     }
 
     public void toggleTrackingButtonOffClicked() {
         navigationExample.stopCameraTracking();
+        isCameraTrackingEnabled = false;
     }
 
     private void calculateRoute(boolean isSimulated) {
@@ -203,7 +206,7 @@ public void clearMap() {
         clearWaypointMapMarker();
         clearRoute();
 
-        navigationExample.stopNavigation();
+        navigationExample.stopNavigation(isCameraTrackingEnabled);
     }
 
     private void clearWaypointMapMarker() {
@@ -279,14 +282,14 @@ private void showStartNavigationDialog(String title, String message, Route route
                .setMessage(message)
                .setNeutralButton(buttonText,
                        (dialog, which) -> {
-                           navigationExample.startNavigation(route, isSimulated);
+                           navigationExample.startNavigation(route, isSimulated, isCameraTrackingEnabled);
                        })
                .show();
     }
 
     public void detach() {
         // Disables TBT guidance (if running) and enters tracking mode.
-        navigationExample.stopNavigation();
+        navigationExample.stopNavigation(isCameraTrackingEnabled);
         // Disables positioning.
         navigationExample.stopLocating();
         // Disables rendering.

examples/latest/navigate/android/Navigation/app/src/main/java/com/here/navigation/NavigationExample.java

@@ -128,7 +128,7 @@ private void createDynamicRoutingEngine() {
         }
     }
 
-    public void startNavigation(Route route, boolean isSimulated) {
+    public void startNavigation(Route route, boolean isSimulated, boolean isCameraTrackingEnabled) {
         GeoCoordinates startGeoCoordinates = route.getGeometry().vertices.get(0);
         prefetchMapData(startGeoCoordinates);
 
@@ -147,6 +147,9 @@ public void startNavigation(Route route, boolean isSimulated) {
         }
 
         startDynamicSearchForBetterRoutes(route);
+
+        // Synchronize with the toggle button state.
+        updateCameraTracking(isCameraTrackingEnabled);
     }
 
     private void startDynamicSearchForBetterRoutes(Route route) {
@@ -179,8 +182,10 @@ public void onRoutingError(@NonNull RoutingError routingError) {
         }
     }
 
-    public void stopNavigation() {
+    public void stopNavigation(boolean isCameraTrackingEnabled) {
         // Switches to tracking mode when a route was set before, otherwise tracking mode is kept.
+        // Note that tracking mode means that the visual navigator will continue to run, but without
+        // turn-by-turn instructions - this can be done with or without camera tracking.
         // Without a route the navigator will only notify on the current map-matched location
         // including info such as speed and current street name.
         visualNavigator.setRoute(null);
@@ -191,6 +196,17 @@ public void stopNavigation() {
 
         dynamicRoutingEngine.stop();
         routePrefetcher.stopPrefetchAroundRoute();
+
+        // Synchronize with the toggle button state.
+        updateCameraTracking(isCameraTrackingEnabled);
+    }
+
+    private void updateCameraTracking(boolean isCameraTrackingEnabled) {
+        if (isCameraTrackingEnabled) {
+            startCameraTracking();
+        } else {
+            stopCameraTracking();
+        }
     }
 
     // Provides simulated location updates based on the given route.