- add CameraForCoordinates

Author: tuyen-vuduc

src/libs/Mapbox.Maui/IMapboxView.cs

@@ -86,6 +86,21 @@ public interface IMapboxController
     IPosition GetMapPosition(ScreenPosition position);
     CoordinateBounds GetCoordinateBoundsForCamera(CameraOptions cameraOptions);
     ScreenPosition GetScreenPosition(IPosition position);
+    CameraOptions? CameraForCoordinates(
+        IEnumerable<MapPosition> coordinates,
+        CameraOptions? cameraOptions = default,
+        Thickness? coordinatesPadding = default,
+        double? maxZoom = default,
+        ScreenPosition? offset = default
+    );
+    void CameraForCoordinates(
+        IEnumerable<MapPosition> coordinates,
+        Action<CameraOptions?> completion,
+        CameraOptions? cameraOptions = default,
+        Thickness? coordinatesPadding = default,
+        double? maxZoom = default,
+        ScreenPosition? offset = default
+    );
 }
 
 public class MapTappedEventArgs : EventArgs

src/libs/Mapbox.Maui/Mapbox.Maui.csproj

@@ -61,7 +61,7 @@
 		<RepositoryUrl>https://github.com/tuyen-vuduc/mapbox-maui</RepositoryUrl>
 		<PackageProjectUrl>https://mapbox.tuyen-vuduc.tech</PackageProjectUrl>
 		<PackageRequireLicenseAcceptance>false</PackageRequireLicenseAcceptance>
-		<PackageVersion>11.5.1-alpha02</PackageVersion>
+		<PackageVersion>11.5.1-alpha03</PackageVersion>
 		<PackageReadmeFile>README.md</PackageReadmeFile>
 		<PackageLicenseFile>LICENSE</PackageLicenseFile>
 		<PackageIcon>tv-mapbox.png</PackageIcon>

src/libs/Mapbox.Maui/Platforms/Android/MapboxViewHandler.Camera.cs

@@ -1,4 +1,6 @@
 using Android.Animation;
+using Android.App;
+using Com.Mapbox.Functions;
 using Com.Mapbox.Maps.Plugins.Animation;
 using MapboxMaui.Camera;
 
@@ -12,7 +14,7 @@ public CameraOptions CameraState
         {
             var mapView = mapboxFragment?.MapView;
 
-            if (mapView == null) return default;
+            if (mapView is null) return default;
 
             return mapView.MapboxMap.CameraState.ToX();
         }
@@ -22,7 +24,7 @@ public void EaseTo(CameraOptions cameraOptions, AnimationOptions animationOption
     {
         var mapView = mapboxFragment?.MapView;
 
-        if (mapView == null) return;
+        if (mapView is null) return;
 
         var xcameraOptions = cameraOptions.ToNative();
         var xanimationOptions = animationOptions?.ToNative();
@@ -41,7 +43,7 @@ public void FlyTo(CameraOptions cameraOptions, AnimationOptions animationOptions
     {
         var mapView = mapboxFragment?.MapView;
 
-        if (mapView == null) return;
+        if (mapView is null) return;
 
         var xcameraOptions = cameraOptions.ToNative();
         var xanimationOptions = animationOptions?.ToNative();

src/libs/Mapbox.Maui/Platforms/Android/MapboxViewHandler.Controller.cs

@@ -1,5 +1,7 @@
 
 
+using Com.Mapbox.Functions;
+
 namespace MapboxMaui;
 
 partial class MapboxViewHandler : IMapboxController
@@ -39,4 +41,81 @@ public ScreenPosition GetScreenPosition(IPosition position)
         var coords = mapView.MapboxMap.PixelForCoordinate(position.ToGeoPoint());
         return coords.ToX();
     }
+    
+    /**
+    * Convenience method that returns the [CameraOptions] object for given parameters.
+    *
+    * Note: if the render thread did not yet calculate the size of the map (due to initialization or map resizing) - empty [CameraOptions] will be returned.
+    *  Emptiness could be checked with [CameraOptions.isEmpty]. Consider using asynchronous overloaded method.
+    *
+    * @param coordinates The `coordinates` representing the bounds of the camera.
+    * @param camera The [CameraOptions] which will be applied before calculating the camera for the coordinates. If any of the fields in [CameraOptions] are not provided then the current value from the map for that field will be used.
+    * @param coordinatesPadding The amount of padding in pixels to add to the given `coordinates`.
+    *                           Note: This padding is not applied to the map but to the coordinates provided. If you want to apply padding to the map use param `camera`.
+    * @param maxZoom The maximum zoom level allowed in the returned camera options.
+    * @param offset The center of the given bounds relative to map center in pixels.
+    *
+    * @return The [CameraOptions] object representing the provided parameters if the map size was calculated and empty [CameraOptions] otherwise, see [CameraOptions.isEmpty].
+    *  Also empty [CameraOptions] are returned in case of an internal error.
+    */
+    public CameraOptions? CameraForCoordinates(
+        IEnumerable<MapPosition> coordinates,
+        CameraOptions? cameraOptions = null,
+        Thickness? coordinatesPadding = null,
+        double? maxZoom = null,
+        ScreenPosition? offset = null)
+    {
+        var mapView = mapboxFragment?.MapView;
+
+        if (mapView is null) return default;
+
+        var result = mapView.MapboxMap.CameraForCoordinates(
+            coordinates?.Select(x => x.ToGeoPoint()).ToList(),
+            cameraOptions?.ToNative(),
+            coordinatesPadding?.ToNative(),
+            maxZoom?.ToNative(),
+            offset?.ToScreenCoordinate()
+            );
+        return result.ToX();
+    }
+
+    /**
+    * Convenience method that returns the [CameraOptions] object for given parameters.
+    *
+    * @param coordinates The `coordinates` representing the bounds of the camera.
+    * @param camera The [CameraOptions] which will be applied before calculating the camera for the coordinates. If any of the fields in [CameraOptions] are not provided then the current value from the map for that field will be used.
+    * @param coordinatesPadding The amount of padding in pixels to add to the given `coordinates`.
+    *                           Note: This padding is not applied to the map but to the coordinates provided. If you want to apply padding to the map use param `camera`.
+    * @param maxZoom The maximum zoom level allowed in the returned camera options.
+    * @param offset The center of the given bounds relative to map center in pixels.
+    * @param completion Callback returning the [CameraOptions] object representing the provided parameters. Those [CameraOptions] always take into account actual MapView size and may return empty ([CameraOptions.isEmpty]) options only if an internal error has occurred.
+    */
+    public void CameraForCoordinates(
+        IEnumerable<MapPosition> coordinates,
+        Action<CameraOptions?> completion,
+        CameraOptions? cameraOptions = null,
+        Thickness? coordinatesPadding = null,
+        double? maxZoom = null,
+        ScreenPosition? offset = null)
+    {
+        var mapView = mapboxFragment?.MapView;
+
+        if (mapView is null)
+        {
+            completion(null);
+            return;
+        }
+
+        mapView.MapboxMap.CameraForCoordinates(
+            coordinates?.Select(x => x.ToGeoPoint()).ToList(),
+            cameraOptions?.ToNative(),
+            coordinatesPadding?.ToNative(),
+            maxZoom?.ToNative(),
+            offset?.ToScreenCoordinate(),
+            new Function1Action<Com.Mapbox.Maps.CameraOptions>((result) =>
+            {
+                completion?.Invoke(result.ToX());
+            })
+        );
+    }
 }