Add BRITISH_IMPERIAL voice unit

Author: DzmitryFomchyn

CHANGELOG.md

@@ -9,6 +9,7 @@ Mapbox welcomes participation and contributions from everyone.
 - Added `StepIntersection#access` property which provides a list representing the access type for each road at the step intersection. [#1611](https://github.com/mapbox/mapbox-java/pull/1611)
 - Added `StepIntersection#elevated` property which provides a list indicating whether each road at the step intersection is elevated. [#1611](https://github.com/mapbox/mapbox-java/pull/1611)
 - Added `StepIntersection#bridge` property which provides a list indicating whether each road at the step intersection is a bridge. [#1611](https://github.com/mapbox/mapbox-java/pull/1611)
+- Added a new voice unit value: `DirectionsCriteria#BRITISH_IMPERIAL`. This value is now included in `DirectionsCriteria#VoiceUnitCriteria`. [#1611](https://github.com/mapbox/mapbox-java/pull/1611)
 
 
 ### v7.5.0 - July 31, 2025

services-directions-models/src/main/java/com/mapbox/api/directions/v5/DirectionsCriteria.java

@@ -239,6 +239,13 @@ public final class DirectionsCriteria {
    */
   public static final String METRIC = "metric";
 
+  /**
+   * Change the units to british imperial for voice and visual information.
+   * Note that this won't change other results such as raw distance measurements which will
+   * always be returned in meters.
+   */
+  public static final String BRITISH_IMPERIAL = "british_imperial";
+
   /**
    * Returned route starts at the first provided coordinate in the list. Used specifically for the
    * Optimization API.
@@ -594,7 +601,8 @@ private DirectionsCriteria() {
   @Retention(RetentionPolicy.CLASS)
   @StringDef( {
     IMPERIAL,
-    METRIC
+    METRIC,
+    BRITISH_IMPERIAL
   })
   public @interface VoiceUnitCriteria {
   }

services-directions-models/src/main/java/com/mapbox/api/directions/v5/models/RouteOptions.java

@@ -506,7 +506,8 @@ public List<String> includeList() {
 
   /**
    * A type of units to return in the text for voice instructions.
-   * Can be {@link DirectionsCriteria#IMPERIAL} (default) or {@link DirectionsCriteria#METRIC}.
+   * Can be {@link DirectionsCriteria#IMPERIAL} (default), {@link DirectionsCriteria#METRIC},
+   * or {@link DirectionsCriteria#BRITISH_IMPERIAL}.
    * Must be used in conjunction with {@link RouteOptions#steps()}=true and
    * {@link RouteOptions#steps()}=true
    * and {@link RouteOptions#voiceInstructions()}=true.
@@ -1628,7 +1629,8 @@ public Builder annotationsList(@Nullable List<String> annotations) {
 
     /**
      * A type of units to return in the text for voice instructions.
-     * Can be {@link DirectionsCriteria#IMPERIAL} (default) or {@link DirectionsCriteria#METRIC}.
+     * Can be {@link DirectionsCriteria#IMPERIAL} (default), {@link DirectionsCriteria#METRIC},
+     * or {@link DirectionsCriteria#BRITISH_IMPERIAL}.
      * Must be used in conjunction with {@link RouteOptions#steps()}=true and
      * {@link RouteOptions#steps()}=true
      * and {@link RouteOptions#voiceInstructions()}=true.