Add kml example

Author: stfnkth

examples/standalone/kml_layer.py

@@ -0,0 +1,18 @@
+# See https://openlayers.org/en/latest/examples/data/kml/2012-02-10.kml
+import openlayers as ol
+
+from openlayers.models.formats import KML
+from openlayers.utils import crs_transformer
+
+url = "https://openlayers.org/en/latest/examples/data/kml/2012-02-10.kml"
+
+layer = ol.VectorLayer(
+    source=ol.VectorSource(url=url,format=KML())
+)
+
+center = crs_transformer().transform(876970.8463461736, 5859807.853963373)
+
+m = ol.Map(ol.View(center=center, zoom=10))
+m.add_layer(layer)
+m.add_tooltip()
+m.save()

src/openlayers/map.py

@@ -12,7 +12,6 @@
 from .models.sources import OSM
 from .models.view import View
 from .styles import FlatStyle
-from .utils import default_crs_transformer
 
 
 class Map(object):
@@ -79,19 +78,13 @@ def set_zoom(self, zoom_level: float | int) -> None:
         """
         self.add_view_call("setZoom", zoom_level)
 
-    def set_center(
-        self, lonlat: tuple[float, float] = None, transform: bool = True
-    ) -> None:
+    def set_center(self, lonlat: tuple[float, float]) -> None:
         """Set the center of the map view
 
         Args:
             lonlat (tuple[float, float]): The centerpoint of the map as `(lon, lat)` pair
-            transform (bool): Whether coordinates should be transformed to `EPSG:3857`,
-                which is the default projection of the view
         """
-        # center = default_crs_transformer().transform(*lonlat) if transform else lonlat
-        center = lonlat
-        self.add_view_call("setCenter", center)
+        self.add_view_call("setCenter", lonlat)
 
     def add_layer(self, layer: LayerT | LayerLike | dict) -> None:
         """Add a layer to the map

src/openlayers/models/formats.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from typing import Union
 from .core import OLBaseModel
 
 
@@ -9,3 +10,10 @@ class Format(OLBaseModel): ...
 
 # --- Formats
 class GeoJSON(Format): ...
+
+
+class KML(Format): ...
+
+
+# --- Format type
+FormatT = Union[Format, GeoJSON, KML]

src/openlayers/models/sources.py

@@ -3,7 +3,7 @@
 from pydantic import Field
 
 from .core import OLBaseModel
-from .formats import GeoJSON
+from .formats import GeoJSON, FormatT
 
 # from ..constants import CARTO_ATTRIBUTION
 
@@ -17,7 +17,7 @@ class VectorSource(Source):
     url: str | None = None
     # features: list[dict] | None = None
     geojson: dict | None = Field(None, serialization_alias="@@geojson")
-    format: dict | GeoJSON = GeoJSON()
+    format: FormatT | dict = GeoJSON()
 
 
 class OSM(Source): ...

src/openlayers/utils.py

@@ -14,7 +14,7 @@ def create_icon_src_from_file(filename: str) -> bytes:
     return f"data:image/{image_type};base64," + encoded_image
 
 
-def default_crs_transformer() -> Transformer:
-    crs_from = CRS.from_epsg(4326)
-    crs_to = CRS.from_epsg(3857)
+def crs_transformer(src_epsg=3857, dest_epsg=4326) -> Transformer:
+    crs_from = CRS.from_epsg(src_epsg)
+    crs_to = CRS.from_epsg(dest_epsg)
     return Transformer.from_crs(crs_from=crs_from, crs_to=crs_to, always_xy=True)

tests/test_utils.py

@@ -1,10 +1,10 @@
-from openlayers.utils import default_crs_transformer
+from openlayers.utils import crs_transformer
 
 def test_crs_transformer() -> None:
     lon = -122.4
     lat = 37.74
 
-    transformer = default_crs_transformer()
+    transformer = crs_transformer()
     center = (lon, lat)
     coords = transformer.transform(*center)