Scale bar nautical miles (#6897)

Adds `ScaleBarSettings.distanceUnits`/`ScaleBarViewOptions.units` along
with adding support for nautical scale bar units.
Now scale bar supports: metric, imperial and nautical units.

Addresses: https://mapbox.atlassian.net/browse/MAPSSDK-869

cc @mapbox/maps-android
cc @mapbox/maps-ios
cc @mapbox/sdk-ci

GitOrigin-RevId: 1abaf1d4b41491333bb9ab5061025ebacc5792b9

Author: evil159

CHANGELOG.md

@@ -11,6 +11,8 @@ Mapbox welcomes participation and contributions from everyone.
 ## Bug fixes 🐞
 * Fix an issue where `MapView#snapshot` listener was invoked twice when the map was not ready.
 
+* Introduced `ScaleBarSettings.distanceUnits` property supporting metric, imperial, and nautical units, replacing the boolean `isMetricUnits` property.
+
 # 11.16.0-beta.1 September 23, 2025
 
 ## Features ✨ and improvements 🏁

app/src/androidTest/java/com/mapbox/maps/testapp/scalebar/generated/ScaleBarAttributeParserDefaultValueTest.kt

@@ -11,7 +11,7 @@
     app:mapbox_scaleBarBorderWidth="1dp"
     app:mapbox_scaleBarHeight="5dp"
     app:mapbox_scaleBarGravity="bottom|center_horizontal"
-    app:mapbox_scaleBarIsMetricUnits="true"
+    app:mapbox_scaleBarDistanceUnits="metric"
     app:mapbox_scaleBarMarginBottom="50dp"
     app:mapbox_scaleBarMarginRight="0dp"
     app:mapbox_scaleBarPrimaryColor="@android:color/black"

app/src/androidTest/java/com/mapbox/maps/testapp/scalebar/generated/ScaleBarAttributeParserTest.kt

@@ -18,6 +18,7 @@
     mapbox:mapbox_scaleBarTextBorderWidth = "10dp"
     mapbox:mapbox_scaleBarTextSize = "10dp"
     mapbox:mapbox_scaleBarIsMetricUnits = "false"
+    mapbox:mapbox_scaleBarDistanceUnits = "imperial"
     mapbox:mapbox_scaleBarRefreshInterval = "1000000"
     mapbox:mapbox_scaleBarShowTextBorder = "false"
     mapbox:mapbox_scaleBarRatio = "0.9"

app/src/main/res/layout/activity_scale_bar.xml

@@ -36,7 +36,8 @@
         <attr name="mapbox_gesturesRotateDecelerationEnabled" format="boolean"/>
         <!-- Whether a deceleration animation following a scroll gesture is enabled. True by default. -->
         <attr name="mapbox_gesturesScrollDecelerationEnabled" format="boolean"/>
-        <!-- Whether rotate threshold increases when pinching to zoom. true by default. -->
+        <!-- Whether rotate threshold increases when pinching to zoom. true by default.
+            {@deprecated This property has no effect} -->
         <attr name="mapbox_gesturesIncreaseRotateThresholdWhenPinchingToZoom" format="boolean"/>
         <!-- Whether pinch to zoom threshold increases when rotating. true by default. -->
         <attr name="mapbox_gesturesIncreasePinchToZoomThresholdWhenRotating" format="boolean"/>

app/src/main/res/layout/generated_test_scalebar.xml

@@ -2,7 +2,9 @@
 package com.mapbox.maps.plugin.scalebar {
 
   public final class LocaleUnitResolver {
+    method public com.mapbox.maps.plugin.DistanceUnits getDistanceUnits();
     method public boolean isMetricSystem();
+    property public final com.mapbox.maps.plugin.DistanceUnits distanceUnits;
     property public final boolean isMetricSystem;
     field public static final com.mapbox.maps.plugin.scalebar.LocaleUnitResolver INSTANCE;
   }