Sources module

walkers/src/sources/geoportal.rs

@@ -0,0 +1,32 @@
+use super::{Attribution, TileSource};
+use crate::TileId;
+
+/// Orthophotomap layer from Poland's Geoportal.
+/// <https://www.geoportal.gov.pl/uslugi/usluga-przegladania-wms>
+pub struct Geoportal;
+
+impl TileSource for Geoportal {
+    fn tile_url(&self, tile_id: TileId) -> String {
+        format!(
+            "https://mapy.geoportal.gov.pl/wss/service/PZGIK/ORTO/WMTS/StandardResolution?\
+            &SERVICE=WMTS\
+            &REQUEST=GetTile\
+            &VERSION=1.0.0\
+            &LAYER=ORTOFOTOMAPA\
+            &TILEMATRIXSET=EPSG:3857\
+            &TILEMATRIX=EPSG:3857:{}\
+            &TILEROW={}\
+            &TILECOL={}",
+            tile_id.zoom, tile_id.y, tile_id.x
+        )
+    }
+
+    fn attribution(&self) -> Attribution {
+        Attribution {
+            text: "Główny Urząd Geodezji i Kartografii",
+            url: "https://www.geoportal.gov.pl/",
+            logo_light: None,
+            logo_dark: None,
+        }
+    }
+}

walkers/src/sources/mapbox.rs

@@ -0,0 +1,73 @@
+use crate::TileId;
+
+use super::{Attribution, TileSource};
+
+/// Predefined Mapbox styles.
+/// <https://docs.mapbox.com/api/maps/styles/#classic-mapbox-styles>
+#[derive(Clone, Copy, Default)]
+pub enum MapboxStyle {
+    #[default]
+    Streets,
+    Outdoors,
+    Light,
+    Dark,
+    Satellite,
+    SatelliteStreets,
+    NavigationDay,
+    NavigationNight,
+}
+
+impl MapboxStyle {
+    fn api_slug(&self) -> &'static str {
+        match self {
+            Self::Streets => "streets-v12",
+            Self::Outdoors => "outdoors-v12",
+            Self::Light => "light-v11",
+            Self::Dark => "dark-v11",
+            Self::Satellite => "satellite-v9",
+            Self::SatelliteStreets => "satellite-streets-v12",
+            Self::NavigationDay => "navigation-day-v1",
+            Self::NavigationNight => "navigation-night-v1",
+        }
+    }
+}
+
+/// Mapbox static tile source.
+/// <https://docs.mapbox.com/api/maps/static-tiles/>
+#[derive(Default)]
+pub struct Mapbox {
+    /// Predefined style to use
+    pub style: MapboxStyle,
+    /// Render tiles at 1024x1024 instead of 512x512 (@2x)
+    pub high_resolution: bool,
+    /// Mapbox API key, required
+    pub access_token: String,
+}
+
+impl TileSource for Mapbox {
+    fn tile_url(&self, tile_id: TileId) -> String {
+        format!(
+            "https://api.mapbox.com/styles/v1/mapbox/{}/tiles/512/{}/{}/{}{}?access_token={}",
+            self.style.api_slug(),
+            tile_id.zoom,
+            tile_id.x,
+            tile_id.y,
+            if self.high_resolution { "@2x" } else { "" },
+            self.access_token
+        )
+    }
+
+    fn attribution(&self) -> Attribution {
+        // TODO: Proper linking (https://docs.mapbox.com/help/getting-started/attribution/))
+        Attribution {
+            text: "© Mapbox, © OpenStreetMap",
+            url: "https://www.mapbox.com/about/maps/",
+            logo_light: Some(egui::include_image!("../../assets/mapbox-logo-white.svg")),
+            logo_dark: Some(egui::include_image!("../../assets/mapbox-logo-black.svg")),
+        }
+    }
+
+    fn tile_size(&self) -> u32 {
+        512
+    }
+}

walkers/src/sources/mod.rs

@@ -0,0 +1,28 @@
+//! Some common HTTP tile sources. Make sure you follow terms of usage of the particular source.
+
+mod geoportal;
+mod mapbox;
+mod openstreetmap;
+
+use crate::mercator::TileId;
+pub use geoportal::Geoportal;
+pub use mapbox::{Mapbox, MapboxStyle};
+pub use openstreetmap::OpenStreetMap;
+
+#[derive(Clone)]
+pub struct Attribution {
+    pub text: &'static str,
+    pub url: &'static str,
+    pub logo_light: Option<egui::ImageSource<'static>>,
+    pub logo_dark: Option<egui::ImageSource<'static>>,
+}
+
+pub trait TileSource {
+    fn tile_url(&self, tile_id: TileId) -> String;
+    fn attribution(&self) -> Attribution;
+
+    /// Size of each tile, should be a multiple of 256
+    fn tile_size(&self) -> u32 {
+        256
+    }
+}

walkers/src/sources/openstreetmap.rs

@@ -0,0 +1,23 @@
+use super::{Attribution, TileSource};
+use crate::TileId;
+
+/// <https://www.openstreetmap.org/about>
+pub struct OpenStreetMap;
+
+impl TileSource for OpenStreetMap {
+    fn tile_url(&self, tile_id: TileId) -> String {
+        format!(
+            "https://tile.openstreetmap.org/{}/{}/{}.png",
+            tile_id.zoom, tile_id.x, tile_id.y
+        )
+    }
+
+    fn attribution(&self) -> Attribution {
+        Attribution {
+            text: "OpenStreetMap contributors",
+            url: "https://www.openstreetmap.org/copyright",
+            logo_light: None,
+            logo_dark: None,
+        }
+    }
+}