flet-map 0.1.0__tar.gz

flet_map-0.1.0/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.2
+Name: flet-map
+Version: 0.1.0
+Summary: Map control for Flet
+Author-email: Flet contributors <hello@flet.dev>
+Project-URL: Homepage, https://flet.dev
+Project-URL: Documentation, https://flet.dev/docs/controls/map
+Project-URL: Repository, https://github.com/flet-dev/flet-map
+Project-URL: Issues, https://github.com/flet-dev/flet-map/issues
+Classifier: License :: OSI Approved :: Apache Software License
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: flet>=0.25.2
+
+# Map control for Flet
+
+`Map` control for Flet.
+
+## Usage
+
+Add `flet-map` as dependency (`pyproject.toml` or `requirements.txt`) to your Flet project.
+
+## Example
+
+```py
+
+import random
+import flet as ft
+import flet_map as map
+
+
+def main(page: ft.Page):
+    marker_layer_ref = ft.Ref[map.MarkerLayer]()
+    circle_layer_ref = ft.Ref[map.CircleLayer]()
+
+    def handle_tap(e: map.MapTapEvent):
+        print(e)
+        if e.name == "tap":
+            marker_layer_ref.current.markers.append(
+                map.Marker(
+                    content=ft.Icon(
+                        ft.Icons.LOCATION_ON, color=ft.cupertino_colors.DESTRUCTIVE_RED
+                    ),
+                    coordinates=e.coordinates,
+                )
+            )
+        elif e.name == "secondary_tap":
+            circle_layer_ref.current.circles.append(
+                map.CircleMarker(
+                    radius=random.randint(5, 10),
+                    coordinates=e.coordinates,
+                    color=ft.Colors.random_color(),
+                    border_color=ft.Colors.random_color(),
+                    border_stroke_width=4,
+                )
+            )
+        page.update()
+
+    def handle_event(e: map.MapEvent):
+        print(e)
+
+    page.add(
+        ft.Text("Click anywhere to add a Marker, right-click to add a CircleMarker."),
+        map.Map(
+            expand=True,
+            initial_center=map.MapLatitudeLongitude(15, 10),
+            initial_zoom=4.2,
+            interaction_configuration=map.MapInteractionConfiguration(
+                flags=map.MapInteractiveFlag.ALL
+            ),
+            on_init=lambda e: print(f"Initialized Map"),
+            on_tap=handle_tap,
+            on_secondary_tap=handle_tap,
+            on_long_press=handle_tap,
+            on_event=lambda e: print(e),
+            layers=[
+                map.TileLayer(
+                    url_template="https://tile.openstreetmap.org/{z}/{x}/{y}.png",
+                    on_image_error=lambda e: print("TileLayer Error"),
+                ),
+                map.RichAttribution(
+                    attributions=[
+                        map.TextSourceAttribution(
+                            text="OpenStreetMap Contributors",
+                            on_click=lambda e: e.page.launch_url(
+                                "https://openstreetmap.org/copyright"
+                            ),
+                        ),
+                        map.TextSourceAttribution(
+                            text="Flet",
+                            on_click=lambda e: e.page.launch_url("https://flet.dev"),
+                        ),
+                    ]
+                ),
+                map.SimpleAttribution(
+                    text="Flet",
+                    alignment=ft.alignment.top_right,
+                    on_click=lambda e: print("Clicked SimpleAttribution"),
+                ),
+                map.MarkerLayer(
+                    ref=marker_layer_ref,
+                    markers=[
+                        map.Marker(
+                            content=ft.Icon(ft.Icons.LOCATION_ON),
+                            coordinates=map.MapLatitudeLongitude(30, 15),
+                        ),
+                        map.Marker(
+                            content=ft.Icon(ft.Icons.LOCATION_ON),
+                            coordinates=map.MapLatitudeLongitude(10, 10),
+                        ),
+                        map.Marker(
+                            content=ft.Icon(ft.Icons.LOCATION_ON),
+                            coordinates=map.MapLatitudeLongitude(25, 45),
+                        ),
+                    ],
+                ),
+                map.CircleLayer(
+                    ref=circle_layer_ref,
+                    circles=[
+                        map.CircleMarker(
+                            radius=10,
+                            coordinates=map.MapLatitudeLongitude(16, 24),
+                            color=ft.Colors.RED,
+                            border_color=ft.Colors.BLUE,
+                            border_stroke_width=4,
+                        ),
+                    ],
+                ),
+                map.PolygonLayer(
+                    polygons=[
+                        map.PolygonMarker(
+                            label="Popular Touristic Area",
+                            label_text_style=ft.TextStyle(
+                                color=ft.Colors.BLACK,
+                                size=15,
+                                weight=ft.FontWeight.BOLD,
+                            ),
+                            color=ft.Colors.with_opacity(0.3, ft.Colors.BLUE),
+                            coordinates=[
+                                map.MapLatitudeLongitude(10, 10),
+                                map.MapLatitudeLongitude(30, 15),
+                                map.MapLatitudeLongitude(25, 45),
+                            ],
+                        ),
+                    ],
+                ),
+                map.PolylineLayer(
+                    polylines=[
+                        map.PolylineMarker(
+                            border_stroke_width=3,
+                            border_color=ft.Colors.RED,
+                            gradient_colors=[ft.Colors.BLACK, ft.Colors.BLACK],
+                            color=ft.Colors.with_opacity(0.6, ft.Colors.GREEN),
+                            coordinates=[
+                                map.MapLatitudeLongitude(10, 10),
+                                map.MapLatitudeLongitude(30, 15),
+                                map.MapLatitudeLongitude(25, 45),
+                            ],
+                        ),
+                    ],
+                ),
+            ],
+        ),
+    )
+
+
+ft.app(main)
+```

flet_map-0.1.0/README.md

@@ -0,0 +1,154 @@
+# Map control for Flet
+
+`Map` control for Flet.
+
+## Usage
+
+Add `flet-map` as dependency (`pyproject.toml` or `requirements.txt`) to your Flet project.
+
+## Example
+
+```py
+
+import random
+import flet as ft
+import flet_map as map
+
+
+def main(page: ft.Page):
+    marker_layer_ref = ft.Ref[map.MarkerLayer]()
+    circle_layer_ref = ft.Ref[map.CircleLayer]()
+
+    def handle_tap(e: map.MapTapEvent):
+        print(e)
+        if e.name == "tap":
+            marker_layer_ref.current.markers.append(
+                map.Marker(
+                    content=ft.Icon(
+                        ft.Icons.LOCATION_ON, color=ft.cupertino_colors.DESTRUCTIVE_RED
+                    ),
+                    coordinates=e.coordinates,
+                )
+            )
+        elif e.name == "secondary_tap":
+            circle_layer_ref.current.circles.append(
+                map.CircleMarker(
+                    radius=random.randint(5, 10),
+                    coordinates=e.coordinates,
+                    color=ft.Colors.random_color(),
+                    border_color=ft.Colors.random_color(),
+                    border_stroke_width=4,
+                )
+            )
+        page.update()
+
+    def handle_event(e: map.MapEvent):
+        print(e)
+
+    page.add(
+        ft.Text("Click anywhere to add a Marker, right-click to add a CircleMarker."),
+        map.Map(
+            expand=True,
+            initial_center=map.MapLatitudeLongitude(15, 10),
+            initial_zoom=4.2,
+            interaction_configuration=map.MapInteractionConfiguration(
+                flags=map.MapInteractiveFlag.ALL
+            ),
+            on_init=lambda e: print(f"Initialized Map"),
+            on_tap=handle_tap,
+            on_secondary_tap=handle_tap,
+            on_long_press=handle_tap,
+            on_event=lambda e: print(e),
+            layers=[
+                map.TileLayer(
+                    url_template="https://tile.openstreetmap.org/{z}/{x}/{y}.png",
+                    on_image_error=lambda e: print("TileLayer Error"),
+                ),
+                map.RichAttribution(
+                    attributions=[
+                        map.TextSourceAttribution(
+                            text="OpenStreetMap Contributors",
+                            on_click=lambda e: e.page.launch_url(
+                                "https://openstreetmap.org/copyright"
+                            ),
+                        ),
+                        map.TextSourceAttribution(
+                            text="Flet",
+                            on_click=lambda e: e.page.launch_url("https://flet.dev"),
+                        ),
+                    ]
+                ),
+                map.SimpleAttribution(
+                    text="Flet",
+                    alignment=ft.alignment.top_right,
+                    on_click=lambda e: print("Clicked SimpleAttribution"),
+                ),
+                map.MarkerLayer(
+                    ref=marker_layer_ref,
+                    markers=[
+                        map.Marker(
+                            content=ft.Icon(ft.Icons.LOCATION_ON),
+                            coordinates=map.MapLatitudeLongitude(30, 15),
+                        ),
+                        map.Marker(
+                            content=ft.Icon(ft.Icons.LOCATION_ON),
+                            coordinates=map.MapLatitudeLongitude(10, 10),
+                        ),
+                        map.Marker(
+                            content=ft.Icon(ft.Icons.LOCATION_ON),
+                            coordinates=map.MapLatitudeLongitude(25, 45),
+                        ),
+                    ],
+                ),
+                map.CircleLayer(
+                    ref=circle_layer_ref,
+                    circles=[
+                        map.CircleMarker(
+                            radius=10,
+                            coordinates=map.MapLatitudeLongitude(16, 24),
+                            color=ft.Colors.RED,
+                            border_color=ft.Colors.BLUE,
+                            border_stroke_width=4,
+                        ),
+                    ],
+                ),
+                map.PolygonLayer(
+                    polygons=[
+                        map.PolygonMarker(
+                            label="Popular Touristic Area",
+                            label_text_style=ft.TextStyle(
+                                color=ft.Colors.BLACK,
+                                size=15,
+                                weight=ft.FontWeight.BOLD,
+                            ),
+                            color=ft.Colors.with_opacity(0.3, ft.Colors.BLUE),
+                            coordinates=[
+                                map.MapLatitudeLongitude(10, 10),
+                                map.MapLatitudeLongitude(30, 15),
+                                map.MapLatitudeLongitude(25, 45),
+                            ],
+                        ),
+                    ],
+                ),
+                map.PolylineLayer(
+                    polylines=[
+                        map.PolylineMarker(
+                            border_stroke_width=3,
+                            border_color=ft.Colors.RED,
+                            gradient_colors=[ft.Colors.BLACK, ft.Colors.BLACK],
+                            color=ft.Colors.with_opacity(0.6, ft.Colors.GREEN),
+                            coordinates=[
+                                map.MapLatitudeLongitude(10, 10),
+                                map.MapLatitudeLongitude(30, 15),
+                                map.MapLatitudeLongitude(25, 45),
+                            ],
+                        ),
+                    ],
+                ),
+            ],
+        ),
+    )
+
+
+ft.app(main)
+```

flet_map-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "flet-map"
+version = "0.1.0"
+description = "Map control for Flet"
+readme = "README.md"
+authors = [
+    { name = "Flet contributors", email = "hello@flet.dev" }
+]
+classifiers = [
+  "License :: OSI Approved :: Apache Software License",
+]
+requires-python = ">=3.8"
+dependencies = [
+    "flet>=0.25.2",
+]
+
+[project.urls]
+Homepage = "https://flet.dev"
+Documentation = "https://flet.dev/docs/controls/map"
+Repository = "https://github.com/flet-dev/flet-map"
+Issues = "https://github.com/flet-dev/flet-map/issues"
+
+[tool.setuptools.package-data]
+"flutter.flet_map" = ["**/*"]
+
+[tool.uv]
+dev-dependencies = [
+    "flet[all]>=0.25.2",
+]
+
+[tool.setuptools]
+license-files = []
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"

flet_map-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

flet_map-0.1.0/src/flet_map/__init__.py

@@ -0,0 +1,30 @@
+from flet_map.circle_layer import CircleLayer, CircleMarker
+from flet_map.map import (
+    Map,
+    MapEvent,
+    MapEventSource,
+    MapHoverEvent,
+    MapInteractionConfiguration,
+    MapInteractiveFlag,
+    MapLatitudeLongitude,
+    MapLatitudeLongitudeBounds,
+    MapMultiFingerGesture,
+    MapPointerDeviceType,
+    MapPointerEvent,
+    MapPositionChangeEvent,
+    MapTapEvent,
+)
+from flet_map.marker_layer import Marker, MarkerLayer
+from flet_map.polygon_layer import PolygonLayer, PolygonMarker
+from flet_map.polyline_layer import (
+    DashedStrokePattern,
+    DottedStrokePattern,
+    PatternFit,
+    PolylineLayer,
+    PolylineMarker,
+    SolidStrokePattern,
+)
+from flet_map.rich_attribution import RichAttribution
+from flet_map.simple_attribution import SimpleAttribution
+from flet_map.text_source_attribution import TextSourceAttribution
+from flet_map.tile_layer import MapTileLayerEvictErrorTileStrategy, TileLayer

flet_map-0.1.0/src/flet_map/circle_layer.py

@@ -0,0 +1,156 @@
+from typing import Any, List, Optional, Union
+
+from flet.core.control import Control, OptionalNumber
+from flet_map.map import MapLatitudeLongitude
+from flet_map.map_layer import MapLayer
+from flet.core.ref import Ref
+from flet.core.types import ColorEnums, ColorValue
+
+
+class CircleMarker(Control):
+    """
+    A circular marker displayed on the Map at the specified location through the CircleLayer.
+
+    -----
+
+    Online docs: https://flet.dev/docs/controls/mapcirclemarker
+    """
+
+    def __init__(
+        self,
+        radius: Union[int, float],
+        coordinates: MapLatitudeLongitude,
+        color: Optional[ColorValue] = None,
+        border_color: Optional[ColorValue] = None,
+        border_stroke_width: OptionalNumber = None,
+        use_radius_in_meter: Optional[bool] = None,
+        #
+        # Control
+        #
+        ref: Optional[Ref] = None,
+        visible: Optional[bool] = None,
+        data: Any = None,
+    ):
+
+        Control.__init__(
+            self,
+            ref=ref,
+            visible=visible,
+            data=data,
+        )
+
+        self.coordinates = coordinates
+        self.color = color
+        self.border_color = border_color
+        self.border_stroke_width = border_stroke_width
+        self.use_radius_in_meter = use_radius_in_meter
+        self.radius = radius
+
+    def _get_control_name(self):
+        return "map_circle_marker"
+
+    def before_update(self):
+        super().before_update()
+        self._set_attr_json("coordinates", self.__coordinates)
+
+    # use_radius_in_meter
+    @property
+    def use_radius_in_meter(self) -> bool:
+        return self._get_attr("useRadiusInMeter", data_type="bool", def_value=False)
+
+    @use_radius_in_meter.setter
+    def use_radius_in_meter(self, value: Optional[bool]):
+        self._set_attr("useRadiusInMeter", value)
+
+    # color
+    @property
+    def color(self) -> Optional[ColorValue]:
+        return self.__color
+
+    @color.setter
+    def color(self, value: Optional[ColorValue]):
+        self.__color = value
+        self._set_enum_attr("color", value, ColorEnums)
+
+    # border_color
+    @property
+    def border_color(self) -> Optional[ColorValue]:
+        return self.__border_color
+
+    @border_color.setter
+    def border_color(self, value: Optional[ColorValue]):
+        self.__border_color = value
+        self._set_enum_attr("borderColor", value, ColorEnums)
+
+    # radius
+    @property
+    def radius(self) -> Union[int, float]:
+        return self._get_attr("radius", data_type="float")
+
+    @radius.setter
+    def radius(self, value: Union[int, float]):
+        self._set_attr("radius", value)
+
+    # border_stroke_width
+    @property
+    def border_stroke_width(self) -> OptionalNumber:
+        return self._get_attr("borderStrokeWidth", data_type="float")
+
+    @border_stroke_width.setter
+    def border_stroke_width(self, value: OptionalNumber):
+        assert value is None or value >= 0, "border_stroke_width cannot be negative"
+        self._set_attr("borderStrokeWidth", value)
+
+    # coordinates
+    @property
+    def coordinates(self) -> MapLatitudeLongitude:
+        return self.__coordinates
+
+    @coordinates.setter
+    def coordinates(self, value: MapLatitudeLongitude):
+        self.__coordinates = value
+
+
+class CircleLayer(MapLayer):
+    """
+    A layer to display CircleMarkers.
+
+    -----
+
+    Online docs: https://flet.dev/docs/controls/mapcirclelayer
+    """
+
+    def __init__(
+        self,
+        circles: List[CircleMarker],
+        #
+        # MapLayer
+        #
+        ref: Optional[Ref] = None,
+        visible: Optional[bool] = None,
+        data: Any = None,
+    ):
+
+        MapLayer.__init__(
+            self,
+            ref=ref,
+            visible=visible,
+            data=data,
+        )
+
+        self.circles = circles
+
+    def _get_control_name(self):
+        return "map_circle_layer"
+
+    def _get_children(self):
+        return self.__circles
+
+    # circles
+    @property
+    def circles(self) -> List[CircleMarker]:
+        return self.__circles
+
+    @circles.setter
+    def circles(self, value: List[CircleMarker]):
+        self.__circles = value