Struct FileSystemTileProtocol 

pub struct FileSystemTileProtocol { /* private fields */ }

Local file-system tile protocol.

Reads tiles from disk laid out as base_path/{z}/{x}/{y}.{ext}, where the extension is derived from the requested TileFormat. This is a real, Pure-Rust protocol with no network dependency — usable directly or as the backing store for super::provider::TileSource::FileSystem.

Implementations

impl FileSystemTileProtocol

pub fn new(base_path: impl Into<PathBuf>, format: TileFormat) -> Self

Create a new file-system tile protocol rooted at base_path.

The default supported zoom range is 0..=31; restrict it with Self::with_zoom_levels.

pub fn with_zoom_levels(self, min_zoom: u8, max_zoom: u8) -> Self

Restrict the supported zoom range.

pub fn with_tile_size(self, width: u32, height: u32) -> Self

Set the tile size in pixels.

pub fn tile_path(&self, coord: &TileCoordinate) -> PathBuf

On-disk path for a tile: base_path/{z}/{x}/{y}.{ext}.

Trait Implementations

impl TileProtocol for FileSystemTileProtocol

fn get_tile<'life0, 'life1, 'async_trait>( &'life0 self, request: &'life1 TileRequest, ) -> Pin<Box<dyn Future<Output = Result<TileResponse>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get a tile.

fn has_tile<'life0, 'life1, 'async_trait>( &'life0 self, coord: &'life1 TileCoordinate, ) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Check if a tile exists.

fn get_tile_metadata<'life0, 'life1, 'async_trait>( &'life0 self, coord: &'life1 TileCoordinate, ) -> Pin<Box<dyn Future<Output = Result<TileMetadata>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get tile metadata.

fn zoom_levels(&self) -> (u8, u8)

Get the supported zoom levels.

fn tile_size(&self) -> (u32, u32)

Get the tile size in pixels.