[WIP] PointClusteringExample

Author: tuyen-vuduc

src/libs/Mapbox.Maui/IMapboxView.cs

@@ -41,8 +41,8 @@ partial interface IMapboxView {
 
 public interface IAnnotationController
 {
-    public IPolygonAnnotationManager CreatePolygonAnnotationManager(string id, LayerPosition layerPosition);
-    public ICircleAnnotationManager CreateCircleAnnotationManager(string id, LayerPosition layerPosition);
-    //public IPointAnnotationManager CreatePointAnnotationManager(string id, LayerPosition layerPosition);
+    IPolygonAnnotationManager CreatePolygonAnnotationManager(string id, LayerPosition layerPosition);
+    ICircleAnnotationManager CreateCircleAnnotationManager(string id, LayerPosition layerPosition);
+    IPointAnnotationManager CreatePointAnnotationManager(string id, LayerPosition layerPosition, ClusterOptions clusterOptions = null);
     //public IPolylineAnnotationManager CreatePolylineAnnotationManager(string, LayerPosition layerPosition);
 }

src/libs/Mapbox.Maui/Models/Annotations/ClusterOptions.cs

@@ -0,0 +1,67 @@
+using MapboxMaui.Expressions;
+
+namespace MapboxMaui.Annotations;
+
+public class ClusterOptions
+{
+    /// The circle radius of the cluster items, 18 by default. Units in pixels.
+    public PropertyValue<double> CircleRadius { get; set; }
+
+    /// The circle color, black by default.
+    public PropertyValue<Color> CircleColor { get; set; }
+
+    /// The text color of cluster item, white by default
+    public PropertyValue<Color> TextColor { get; set; }
+
+    /// The text size of cluster item, 12 by default. Units in pixels.
+    public PropertyValue<double> TextSize { get; set; }
+
+    /// Value to use for a text label of the cluster. `get("point_count")` by default which
+    /// will show the count of points in the cluster
+    public PropertyValue<string> TextField { get; set; }
+
+    /// Radius of each cluster if clustering is enabled. A value of 512 indicates a radius equal
+    /// to the width of a tile, 50 by default. Value must be greater than or equal to 0.
+    public double ClusterRadius { get; set; }
+
+    /// Max zoom on which to cluster points if clustering is enabled. Defaults to one zoom less
+    /// than maxzoom (so that last zoom features are not clustered). Clusters are re-evaluated at integer zoom
+    /// levels so setting clusterMaxZoom to 14 means the clusters will be displayed until z15.
+    public double ClusterMaxZoom { get; set; }
+
+    /// An object defining custom properties on the generated clusters if clustering is enabled, aggregating values from
+    /// clustered points. Has the form `{"property_name": [operator, map_expression]}`.
+    /// `operator` is any expression function that accepts at
+    /// least 2 operands (e.g. `"+"` or `"max"`) — it accumulates the property value from clusters/points the
+    /// cluster contains; `map_expression` produces the value of a single point. Example:
+    ///
+    /// ``Expression`` syntax:
+    /// ```
+    /// let expression = Exp(.sum) {
+    ///     Exp(.get) { "scalerank" }
+    /// }
+    /// clusterProperties: ["sum": expression]
+    /// ```
+    ///
+    /// JSON syntax:
+    /// `{"sum": ["+", ["get", "scalerank"]]}`
+    ///
+    /// For more advanced use cases, in place of `operator`, you can use a custom reduce expression that references a special `["accumulated"]` value. Example:
+    ///
+    /// ``Expression`` syntax:
+    /// ```
+    /// let expression = Exp {
+    ///     Exp(.sum) {
+    ///         Exp(.accumulated)
+    ///         Exp(.get) { "sum" }
+    ///     }
+    ///     Exp(.get) { "scalerank" }
+    /// }
+    /// clusterProperties: ["sum": expression]
+    /// ```
+    /// 
+    /// JSON syntax:
+    /// `{"sum": [["+", ["accumulated"], ["get", "sum"]], ["get", "scalerank"]]}`
+    public IDictionary<string, DslExpression> ClusterProperties { get; set; }
+}
+

src/libs/Mapbox.Maui/Models/Annotations/IPointAnnotationManager.cs

@@ -0,0 +1,39 @@
+namespace MapboxMaui.Annotations;
+
+public interface IPointAnnotationManager : IAnnotationManager<PointAnnotation>
+{
+    bool? IconAllowOverlap { get; set; }
+    bool? IconIgnorePlacement { get; set; }
+    bool? IconKeepUpright { get; set; }
+    bool? IconOptional { get; set; }
+    double? IconPadding { get; set; }
+    IconPitchAlignment? IconPitchAlignment { get; set; }
+    IconRotationAlignment? IconRotationAlignment { get; set; }
+    IconTextFit? IconTextFit { get; set; }
+    double[] IconTextFitPadding { get; set; }
+    bool? SymbolAvoidEdges { get; set; }
+    SymbolPlacement? SymbolPlacement { get; set; }
+    double? SymbolSpacing { get; set; }
+    SymbolZOrder? SymbolZOrder { get; set; }
+    bool? TextAllowOverlap { get; set; }
+    string[] TextFont { get; set; }
+    bool? TextIgnorePlacement { get; set; }
+    bool? TextKeepUpright { get; set; }
+    double? TextMaxAngle { get; set; }
+    bool? TextOptional { get; set; }
+    double? TextPadding { get; set; }
+    TextPitchAlignment? TextPitchAlignment { get; set; }
+    TextRotationAlignment? TextRotationAlignment { get; set; }
+    TextAnchor[] TextVariableAnchor { get; set; }
+    TextWritingMode[] TextWritingMode { get; set; }
+    double[] IconTranslate { get; set; }
+    IconTranslateAnchor? IconTranslateAnchor { get; set; }
+    double[] TextTranslate { get; set; }
+    TextTranslateAnchor? TextTranslateAnchor { get; set; }
+    double? TextLineHeight { get; set; }
+}
+
+public partial class PointAnnotationManager
+{
+}
+