expose the concurrent camera animations during navigation to android

this makes it so that users of the android integration can choose
to have indepedent camera animations run concurrently instead
of them waiting on each other or canceling each other.

Author: yousifd

platform/android/MapLibreAndroid/src/main/java/org/maplibre/android/location/LocationCameraController.java

@@ -330,7 +330,7 @@ void setEnabled(boolean enabled) {
     isEnabled = enabled;
   }
 
-  private boolean isLocationTracking() {
+  boolean isLocationTracking() {
     return cameraMode == CameraMode.TRACKING
       || cameraMode == CameraMode.TRACKING_COMPASS
       || cameraMode == CameraMode.TRACKING_GPS

platform/android/MapLibreAndroid/src/main/java/org/maplibre/android/location/LocationComponent.java

@@ -1387,6 +1387,10 @@ private void updateAnimatorListenerHolders() {
     locationAnimatorCoordinator.resetAllLayerAnimations();
   }
 
+  public boolean isLocationTracking() {
+    return locationCameraController.isLocationTracking();
+  }
+
   @NonNull
   private OnCameraMoveListener onCameraMoveListener = new OnCameraMoveListener() {
     @Override
@@ -1546,7 +1550,7 @@ public void onRenderModeChanged(int currentMode) {
     new MapLibreMap.OnDeveloperAnimationListener() {
       @Override
       public void onDeveloperAnimationStarted() {
-        if (isComponentInitialized && isEnabled) {
+        if (isComponentInitialized && isEnabled && !options.concurrentCameraAnimationsEnabled()) {
           setCameraMode(CameraMode.NONE);
         }
       }

platform/android/MapLibreAndroid/src/main/java/org/maplibre/android/location/LocationComponentOptions.java

@@ -144,6 +144,7 @@ public class LocationComponentOptions implements Parcelable {
   private float pulseAlpha;
   @Nullable
   private Interpolator pulseInterpolator;
+  private Boolean concurrentCameraAnimationsEnabled;
 
   public LocationComponentOptions(
     float accuracyAlpha,
@@ -186,7 +187,8 @@ public LocationComponentOptions(
     float pulseSingleDuration,
     float pulseMaxRadius,
     float pulseAlpha,
-    @Nullable Interpolator pulseInterpolator) {
+    @Nullable Interpolator pulseInterpolator,
+    Boolean concurrentCameraAnimationsEnabled) {
     this.accuracyAlpha = accuracyAlpha;
     this.accuracyColor = accuracyColor;
     this.backgroundDrawableStale = backgroundDrawableStale;
@@ -231,6 +233,7 @@ public LocationComponentOptions(
     this.pulseMaxRadius = pulseMaxRadius;
     this.pulseAlpha = pulseAlpha;
     this.pulseInterpolator = pulseInterpolator;
+    this.concurrentCameraAnimationsEnabled = concurrentCameraAnimationsEnabled;
   }
 
   /**
@@ -373,6 +376,10 @@ public static LocationComponentOptions createFromAttributes(@NonNull Context con
     builder.pulseAlpha = typedArray.getFloat(
       R.styleable.maplibre_LocationComponent_maplibre_pulsingLocationCircleAlpha, CIRCLE_PULSING_ALPHA_DEFAULT);
 
+    builder.concurrentCameraAnimationsEnabled = typedArray.getBoolean(
+        R.styleable.maplibre_LocationComponent_maplibre_concurrentCameraAnimationsEnabled, false
+    );
+
     typedArray.recycle();
 
     return builder.build();
@@ -892,6 +899,15 @@ public Interpolator pulseInterpolator() {
     return pulseInterpolator;
   }
 
+  /**
+   * Enable or disable concurrent camera animations during navigation
+   *
+   * @return whether concurrent camera animations are enabled or disabled during navigation
+   */
+  public Boolean concurrentCameraAnimationsEnabled() {
+      return concurrentCameraAnimationsEnabled;
+  }
+
   @NonNull
   @Override
   public String toString() {
@@ -934,6 +950,7 @@ public String toString() {
       + "pulseSingleDuration=" + pulseSingleDuration
       + "pulseMaxRadius=" + pulseMaxRadius
       + "pulseAlpha=" + pulseAlpha
+      + "concurrentCameraAnimationsEnabled=" + concurrentCameraAnimationsEnabled
       + "}";
   }
 
@@ -1081,6 +1098,10 @@ public boolean equals(Object o) {
       return false;
     }
 
+    if (concurrentCameraAnimationsEnabled != options.concurrentCameraAnimationsEnabled) {
+        return false;
+    }
+
     return layerBelow != null ? layerBelow.equals(options.layerBelow) : options.layerBelow == null;
   }
 
@@ -1130,6 +1151,7 @@ public int hashCode() {
     result = 31 * result + (pulseSingleDuration != +0.0f ? Float.floatToIntBits(pulseSingleDuration) : 0);
     result = 31 * result + (pulseMaxRadius != +0.0f ? Float.floatToIntBits(pulseMaxRadius) : 0);
     result = 31 * result + (pulseAlpha != +0.0f ? Float.floatToIntBits(pulseAlpha) : 0);
+    result = 31 * result + (concurrentCameraAnimationsEnabled ? 1 : 0);
     return result;
   }
 
@@ -1180,6 +1202,7 @@ public void writeToParcel(Parcel dest, int flags) {
     dest.writeFloat(this.pulseSingleDuration);
     dest.writeFloat(this.pulseMaxRadius);
     dest.writeFloat(this.pulseAlpha);
+    dest.writeByte(this.concurrentCameraAnimationsEnabled ? (byte) 1 : (byte) 0);
   }
 
   protected LocationComponentOptions(Parcel in) {
@@ -1223,6 +1246,7 @@ protected LocationComponentOptions(Parcel in) {
     this.pulseSingleDuration = in.readFloat();
     this.pulseMaxRadius = in.readFloat();
     this.pulseAlpha = in.readFloat();
+    this.concurrentCameraAnimationsEnabled = in.readByte() != 0;
   }
 
   public static final Parcelable.Creator<LocationComponentOptions> CREATOR =
@@ -1349,6 +1373,7 @@ public LocationComponentOptions build() {
     private float pulseAlpha;
     @Nullable
     private Interpolator pulseInterpolator;
+    private Boolean concurrentCameraAnimationsEnabled;
 
     Builder() {
     }
@@ -1395,6 +1420,7 @@ private Builder(LocationComponentOptions source) {
       this.pulseMaxRadius = source.pulseMaxRadius;
       this.pulseAlpha = source.pulseAlpha;
       this.pulseInterpolator = source.pulseInterpolator;
+      this.concurrentCameraAnimationsEnabled = source.concurrentCameraAnimationsEnabled;
     }
 
     /**
@@ -1973,6 +1999,16 @@ public LocationComponentOptions.Builder pulseInterpolator(Interpolator pulseInte
       return this;
     }
 
+    /**
+     * Enable or disable the concurrent camera animations during navigation feature
+     *
+     * @return whether concurrent camera animations are enabled or disabled
+     */
+    public LocationComponentOptions.Builder concurrentCameraAnimationsEnabled(Boolean concurrentCameraAnimationsEnabled) {
+        this.concurrentCameraAnimationsEnabled = concurrentCameraAnimationsEnabled;
+        return this;
+    }
+
     @Nullable
     LocationComponentOptions autoBuild() {
       String missing = "";
@@ -2074,7 +2110,8 @@ LocationComponentOptions autoBuild() {
         this.pulseSingleDuration,
         this.pulseMaxRadius,
         this.pulseAlpha,
-        this.pulseInterpolator);
+        this.pulseInterpolator,
+        this.concurrentCameraAnimationsEnabled);
     }
   }
 }

platform/android/MapLibreAndroid/src/main/java/org/maplibre/android/maps/MapKeyListener.java

@@ -167,6 +167,14 @@ boolean onKeyUp(int keyCode, KeyEvent event) {
         PointF focalPoint = new PointF(uiSettings.getWidth() / 2, uiSettings.getHeight() / 2);
         mapGestureDetector.zoomInAnimated(focalPoint, true);
         return true;
+    case KeyEvent.KEYCODE_DEL:
+        if (!uiSettings.isZoomGesturesEnabled()) {
+            return false;
+        }
+
+        // Zoom out
+        focalPoint = new PointF(uiSettings.getWidth() / 2, uiSettings.getHeight() / 2);
+        mapGestureDetector.zoomOutAnimated(focalPoint, true);
     }
 
     // We are not interested in this key

platform/android/MapLibreAndroid/src/main/java/org/maplibre/android/maps/Transform.java

@@ -190,6 +190,11 @@ CameraPosition invalidateCameraPosition() {
   }
 
   void cancelTransitions() {
+    MapLibreMap map = mapView.getMapLibreMap();
+    if (map != null && map.getLocationComponent().isLocationComponentActivated() && map.getLocationComponent().getLocationComponentOptions().concurrentCameraAnimationsEnabled() && map.getLocationComponent().isLocationTracking()) {
+        return;
+    }
+
     // notify user about cancel
     cameraChangeDispatcher.onCameraMoveCanceled();
 

platform/android/MapLibreAndroid/src/main/res-public/values/public.xml

@@ -173,4 +173,7 @@
     <public name="maplibre_pulsingLocationCircleAlpha" format="float" type="attr" />
     <public name="maplibre_pulsingLocationCircleInterpolator" format="string" type="attr" />
 
+    <!-- Camera Animations -->
+    <public name="maplibre_concurrentCameraAnimationsEnabled" format="boolean" type="attr" />
+
 </resources>

platform/android/MapLibreAndroid/src/main/res/values/attrs.xml

@@ -202,5 +202,8 @@
         <attr name="maplibre_pulsingLocationCircleAlpha" format="float" />
         <attr name="maplibre_pulsingLocationCircleInterpolator" format="string" />
 
+        <!-- Concurrent Camera Animations -->
+        <attr name="maplibre_concurrentCameraAnimationsEnabled" format="boolean" />
+
     </declare-styleable>
 </resources>

platform/android/MapLibreAndroid/src/main/res/values/styles.xml

@@ -42,5 +42,7 @@
     <item name="maplibre_pulsingLocationCircleAlpha">0.4</item>
     <item name="maplibre_pulsingLocationCircleInterpolator">decelerate</item>
 
+    <!-- Concurrent Camera Animations -->
+    <item name="maplibre_concurrentCameraAnimationsEnabled">false</item>
   </style>
 </resources>