Struct TarTilesReader 

pub struct TarTilesReader { /* private fields */ }

Reader for tiles stored inside a tar archive.

Merges TileJSON from recognized metadata files, builds a map from {z,x,y} to byte ranges within the archive, infers uniform format/compression, and exposes tiles via TileSource.

Implementations

impl TarTilesReader

pub fn open_path(path: &Path) -> Result<TarTilesReader>

Open a tar archive and build an index of tiles and metadata.

Scans regular entries in the archive, recognizing:

• tiles at {z}/{x}/{y}.<format>[.<compression>]
• metadata files: meta.json, tiles.json, metadata.json (optionally .gz/.br)

Determines a uniform tile format and compression, and computes a bbox pyramid from discovered coordinates.

Errors

Returns an error if the file cannot be opened, if no tiles are found, or if mixed formats/compressions are encountered.

Trait Implementations

impl Debug for TarTilesReader

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl TileSource for TarTilesReader

fn metadata(&self) -> &TileSourceMetadata

Returns the parameters of the tiles reader.

fn tilejson(&self) -> &TileJSON

Return the parsed TileJSON metadata for this archive.

fn get_tile<'life0, 'life1, 'async_trait>( &'life0 self, coord: &'life1 TileCoord, ) -> Pin<Box<dyn Future<Output = Result<Option<Tile>>> + Send + 'async_trait>>

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

Fetch a single tile by XYZ coordinate.

Looks up the coordinate in the prebuilt index and reads the corresponding byte range from the underlying DataReaderFile. Returns Ok(None) if the tile is absent.

Errors

Propagates I/O errors while reading the tar entry.

fn source_type(&self) -> Arc<SourceType>

Returns the source type (container format, processor name, or composite).

fn get_tile_stream<'life0, 'async_trait>( &'life0 self, bbox: TileBBox, ) -> Pin<Box<dyn Future<Output = Result<TileStream<'_, Tile>>> + Send + 'async_trait>>

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

Asynchronously streams all tiles within the given bounding box.

fn stream_individual_tiles<'life0, 'async_trait>( &'life0 self, bbox: TileBBox, ) -> Pin<Box<dyn Future<Output = Result<TileStream<'_, Tile>>> + Send + 'async_trait>>

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

fn boxed(self) -> Box<dyn TileSource>

where Self: Sized + 'static,

Converts self into a boxed trait object for dynamic dispatch.