Struct HttpTileSource 

pub struct HttpTileSource { /* private fields */ }

A TileSource that fetches raster tiles over HTTP.

Uses a URL template with {z}, {x}, {y} placeholders and an optional TileDecoder for image formats.

See the module-level documentation for the full request lifecycle and error mapping.

Implementations

impl HttpTileSource

pub fn new(url_template: impl Into<String>, client: Box<dyn HttpClient>) -> Self

Create a new HTTP tile source without image decoding.

Response bodies are assumed to be raw RGBA8 256x256 pixel data. For real tile providers (OSM, Mapbox, etc.) use with_decoder instead.

pub fn with_decoder( url_template: impl Into<String>, client: Box<dyn HttpClient>, decoder: Box<dyn TileDecoder>, ) -> Self

Create a new HTTP tile source with a TileDecoder for decoding PNG / JPEG / WebP response bodies into RGBA8.

pub fn with_header( self, name: impl Into<String>, value: impl Into<String>, ) -> Self

Add a default header that will be sent with every tile request.

Useful for API keys, User-Agent overrides, or custom authentication tokens. Returns self for chaining.

Example

let source = HttpTileSource::new(template, client)
    .with_header("User-Agent", "rustial/0.1")
    .with_header("Authorization", "Bearer my-token");

pub fn tile_url(&self, id: &TileId) -> String

Expand the URL template for a given tile ID.

Replaces {z}, {x}, {y} with the tile’s zoom, column, and row respectively.

pub fn url_template(&self) -> &str

The URL template this source was constructed with.

pub fn pending_count(&self) -> usize

The number of requests currently in flight (awaiting HTTP response).

Trait Implementations

impl Debug for HttpTileSource

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

Formats the value using the given formatter.

impl TileSource for HttpTileSource

fn request(&self, id: TileId)

Start fetching a tile. Returns immediately.

fn request_revalidate(&self, id: TileId, hint: RevalidationHint)

Start a conditional revalidation fetch for a stale tile.

fn poll(&self) -> Vec<(TileId, Result<TileResponse, TileError>)>

Poll for completed tile fetches.

fn cancel(&self, id: TileId)

Cancel a previously requested tile fetch.

fn diagnostics(&self) -> Option<TileSourceDiagnostics>

Optional runtime diagnostics about the source fetch pipeline.

fn request_many(&self, ids: &[TileId])

Start fetching multiple tiles.

fn request_revalidate_many(&self, ids: &[(TileId, RevalidationHint)])

Start conditional revalidation for multiple tiles.

fn cancel_many(&self, ids: &[TileId])

Cancel multiple previously requested tile fetches.