Expose native map (#3044)

Author: kiryldz

maps-sdk/api/Release/metalava.txt

@@ -220,6 +220,7 @@ package com.mapbox.maps {
     method public com.mapbox.maps.MapOptions getMapOptions();
     method public double getMetersPerPixelAtLatitude(double latitude, double zoom);
     method public double getMetersPerPixelAtLatitude(double latitude);
+    method @RestrictTo(androidx.annotation.RestrictTo.Scope.LIBRARY_GROUP_PREFIX) @com.mapbox.maps.MapboxDelicateApi @com.mapbox.maps.MapboxExperimental public com.mapbox.maps.Map getNativeMap();
     method public byte getPrefetchZoomDelta();
     method public boolean getRenderWorldCopies();
     method public com.mapbox.maps.Size getSize();

maps-sdk/api/maps-sdk.api

@@ -220,6 +220,7 @@ public final class com/mapbox/maps/MapboxMap : com/mapbox/maps/MapboxStyleManage
 	public fun getMapOptions ()Lcom/mapbox/maps/MapOptions;
 	public fun getMetersPerPixelAtLatitude (D)D
 	public fun getMetersPerPixelAtLatitude (DD)D
+	public final fun getNativeMap ()Lcom/mapbox/maps/Map;
 	public final fun getPrefetchZoomDelta ()B
 	public final fun getRenderWorldCopies ()Z
 	public fun getSize ()Lcom/mapbox/maps/Size;

maps-sdk/src/main/java/com/mapbox/maps/MapboxMap.kt

@@ -2842,6 +2842,14 @@ class MapboxMap :
     }
   }
 
+  /**
+   * For internal usage only.
+   */
+  @MapboxExperimental
+  @MapboxDelicateApi
+  @RestrictTo(RestrictTo.Scope.LIBRARY_GROUP_PREFIX)
+  fun getNativeMap(): Map = nativeMap.map
+
   /**
    * A convenience object to access MapboxMap's static utilities.
    */

maps-sdk/src/test/java/com/mapbox/maps/MapboxMapTest.kt

@@ -1833,6 +1833,14 @@ class MapboxMapTest {
     verifyOnce { mapboxMap.getViewAnnotationAvoidLayers() }
     assertEquals(layerIds, mapboxMap.getViewAnnotationAvoidLayers())
   }
+
+  @OptIn(MapboxExperimental::class, MapboxDelicateApi::class)
+  @Test
+  fun getNativeMap() {
+    val map = mockk<Map>()
+    every { nativeMap.map } returns map
+    assertEquals(mapboxMap.getNativeMap(), map)
+  }
 }
 
 @RunWith(ParameterizedRobolectricTestRunner::class)