Merge pull request #390 from heremaps/esd/42310

Update example apps for release 4.23.1.0

Author: KarmveerKumarHere

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.23.0.0)
+## List of Available Example Apps (Version 4.23.1.0)
 
 - **HelloMap**: Shows the classic 'Hello World'.
 - **HelloMapWithStoryboard**: Shows the classic 'Hello World' using a Storyboard (iOS only).

examples/latest/README.md

@@ -1,4 +1,4 @@
-This folder contains the HERE SDK examples apps for version: 4.23.0.0
+This folder contains the HERE SDK examples apps for version: 4.23.1.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/explore/android/MapItems/app/src/main/java/com/here/mapitems/MainActivity.java

@@ -26,6 +26,7 @@
 import android.view.Menu;
 import android.view.MenuInflater;
 import android.view.MenuItem;
+import android.widget.Toast;
 
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
@@ -184,6 +185,10 @@ public boolean onOptionsItemSelected(@NonNull MenuItem item) {
             case R.id.polyline_menu_item:
                 mapObjectsExample.showMapPolyline();
                 return true;
+            case R.id.polyline_enable_visibility:
+                Toast.makeText(this, "Enabled visibility ranges for MapPolyLine", Toast.LENGTH_SHORT).show();
+                mapObjectsExample.enableVisibilityRangesForPolyline();
+                return true;
             case R.id.clear_map_objects_menu_item:
                 mapObjectsExample.clearMapButtonClicked();
                 return true;

examples/latest/explore/android/MapItems/app/src/main/java/com/here/mapitems/MapObjectsExample.java

@@ -20,6 +20,7 @@
 package com.here.mapitems;
 
 import android.util.Log;
+import android.widget.Toast;
 
 import com.here.sdk.core.Color;
 import com.here.sdk.core.GeoCircle;
@@ -35,6 +36,7 @@
 import com.here.sdk.mapview.MapCameraAnimationFactory;
 import com.here.sdk.mapview.MapMeasure;
 import com.here.sdk.mapview.MapMeasureDependentRenderSize;
+import com.here.sdk.mapview.MapMeasureRange;
 import com.here.sdk.mapview.MapPolygon;
 import com.here.sdk.mapview.MapPolyline;
 import com.here.sdk.mapview.MapScene;
@@ -69,6 +71,21 @@ public void showMapPolyline() {
         mapScene.addMapPolyline(mapPolyline);
     }
 
+    public void enableVisibilityRangesForPolyline(){
+        ArrayList<MapMeasureRange> visibilityRanges = new ArrayList<>();
+
+        // At present, only MapMeasure.Kind.ZOOM_LEVEL is supported for visibility ranges.
+        // Other kinds will be ignored.
+        visibilityRanges.add(new MapMeasureRange(MapMeasure.Kind.ZOOM_LEVEL,1,10));
+        visibilityRanges.add(new MapMeasureRange(MapMeasure.Kind.ZOOM_LEVEL,11,22));
+
+        // Sets the visibility ranges for this map polyline based on zoom levels.
+        // Each range is half-open: [minimumZoomLevel, maximumZoomLevel],
+        // meaning the polyline is visible at minimumZoomLevel but not at maximumZoomLevel.
+        // The polyline is rendered only when the map zoom level falls within any of the defined ranges.
+        mapPolyline.setVisibilityRanges(visibilityRanges);
+    }
+
     public void showMapArrow() {
         clearMap();
         // Move map to expected location.

examples/latest/explore/android/MapItems/app/src/main/res/menu/map_option_menu.xml

@@ -14,6 +14,8 @@
               android:title="Polygon"/>
           <item android:id="@+id/circle_menu_item"
               android:title="Circle"/>
+          <item android:id="@+id/polyline_enable_visibility"
+              android:title="Enable visibility ranges"/>
           <item android:id="@+id/clear_map_objects_menu_item"
               android:title="Clear Items"/>
       </menu>

examples/latest/explore/android/Routing/app/src/main/java/com/here/routing/RoutingExample.java

@@ -386,6 +386,14 @@ private CarOptions getCarOptions() {
         // This is needed when e.g. requesting TrafficOnRoute data.
         carOptions.routeOptions.enableRouteHandle = true;
 
+        // Enable usage of HOV and HOT lanes.
+        // Note: These lanes will only be used if they are available in the selected country.
+        carOptions.allowOptions.allowHov = true;
+        carOptions.allowOptions.allowHot = true;
+
+        // When occupantsNumber is greater than 1, it enables the vehicle to use HOV/HOT lanes.
+        carOptions.occupantsNumber = 4;
+
         // Disabled - Traffic optimization is completely disabled, including long-term road closures. It helps in producing stable routes.
         // Time dependent - Traffic optimization is enabled, the shape of the route will be adjusted according to the traffic situation which depends on departure time and arrival time.
         carOptions.routeOptions.trafficOptimizationMode = trafficDisabled ?

examples/latest/explore/android/RoutingKotlin/app/src/main/java/com/here/routingkotlin/RoutingExample.kt

@@ -312,6 +312,15 @@ class RoutingExample(private val context: Context, private val mapView: MapView)
         get() {
             val carOptions = CarOptions()
             carOptions.routeOptions.enableTolls = true
+
+            // Enable usage of HOV and HOT lanes.
+            // Note: These lanes will only be used if they are available in the selected country.
+            carOptions.allowOptions.allowHov = true;
+            carOptions.allowOptions.allowHot = true;
+
+            // When occupantsNumber is greater than 1, it enables the vehicle to use HOV/HOT lanes.
+            carOptions.occupantsNumber = 4
+
             // Disabled - Traffic optimization is completely disabled, including long-term road closures. It helps in producing stable routes.
             // Time dependent - Traffic optimization is enabled, the shape of the route will be adjusted according to the traffic situation which depends on departure time and arrival time.
             carOptions.routeOptions.trafficOptimizationMode =

examples/latest/explore/android/Traffic/app/src/main/java/com/here/traffic/TrafficExample.java

@@ -53,6 +53,7 @@
 import com.here.sdk.traffic.TrafficIncidentLookupOptions;
 import com.here.sdk.traffic.TrafficIncidentsQueryCallback;
 import com.here.sdk.traffic.TrafficIncidentsQueryOptions;
+import com.here.sdk.traffic.TrafficLocation;
 import com.here.sdk.traffic.TrafficQueryError;
 import com.here.time.Duration;
 
@@ -204,7 +205,14 @@ public void onTrafficIncidentFetched(@Nullable TrafficQueryError trafficQueryErr
                 if (trafficQueryError == null) {
                     Log.d(TAG, "Fetched TrafficIncident from lookup request." +
                             " Description: " + trafficIncident.getDescription().text);
-                    addTrafficIncidentsMapPolyline(trafficIncident.getLocation().polyline);
+
+                    TrafficLocation incidentLocation = trafficIncident.getLocation();
+                    addTrafficIncidentsMapPolyline(incidentLocation.polyline);
+
+                    // If the polyline contains any gaps, they are available as additionalPolylines in TrafficLocation.
+                    for (GeoPolyline additionalPolyLine : incidentLocation.additionalPolylines) {
+                        addTrafficIncidentsMapPolyline(additionalPolyLine);
+                    }
                 } else {
                     showDialog("TrafficLookupError:", trafficQueryError.toString());
                 }
@@ -273,13 +281,22 @@ private TrafficIncident getNearestTrafficIncident(GeoCoordinates currentGeoCoord
         double nearestDistance = Double.MAX_VALUE;
         TrafficIncident nearestTrafficIncident = null;
         for (TrafficIncident trafficIncident : trafficIncidentsList) {
-            // In case lengthInMeters == 0 then the polyline consistes of two equal coordinates.
+            List<GeoPolyline> trafficIncidentPolyLines = new ArrayList<>();
+
+            // In case lengthInMeters == 0 then the polyline consists of two equal coordinates.
             // It is guaranteed that each incident has a valid polyline.
-            for (GeoCoordinates geoCoords : trafficIncident.getLocation().polyline.vertices) {
-                double currentDistance = currentGeoCoords.distanceTo(geoCoords);
-                if (currentDistance < nearestDistance) {
-                    nearestDistance = currentDistance;
-                    nearestTrafficIncident = trafficIncident;
+            trafficIncidentPolyLines.add(trafficIncident.getLocation().polyline);
+
+            // If the polyline contains any gaps, they are available as additionalPolylines in TrafficLocation.
+            trafficIncidentPolyLines.addAll(trafficIncident.getLocation().additionalPolylines);
+
+            for (GeoPolyline trafficIncidentPolyline : trafficIncidentPolyLines) {
+                for (GeoCoordinates geoCoords : trafficIncidentPolyline.vertices) {
+                    double currentDistance = currentGeoCoords.distanceTo(geoCoords);
+                    if (currentDistance < nearestDistance) {
+                        nearestDistance = currentDistance;
+                        nearestTrafficIncident = trafficIncident;
+                    }
                 }
             }
         }

examples/latest/explore/flutter/camera_app/.gitignore

@@ -8,6 +8,7 @@
 .buildlog/
 .history
 .svn/
+.cxx/
 
 # IntelliJ related
 *.iml

examples/latest/explore/flutter/camera_app/ios/Runner.xcodeproj/project.pbxproj

@@ -343,7 +343,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				SDKROOT = iphoneos;
 				SUPPORTED_PLATFORMS = iphoneos;
@@ -366,7 +366,7 @@
 					"$(PROJECT_DIR)/Flutter",
 				);
 				INFOPLIST_FILE = Runner/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
@@ -430,7 +430,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
 				MTL_ENABLE_DEBUG_INFO = YES;
 				ONLY_ACTIVE_ARCH = YES;
 				SDKROOT = iphoneos;
@@ -479,7 +479,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				SDKROOT = iphoneos;
 				SUPPORTED_PLATFORMS = iphoneos;
@@ -504,7 +504,7 @@
 					"$(PROJECT_DIR)/Flutter",
 				);
 				INFOPLIST_FILE = Runner/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
@@ -536,7 +536,7 @@
 					"$(PROJECT_DIR)/Flutter",
 				);
 				INFOPLIST_FILE = Runner/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",