Struct HttpVectorTileSource 

pub struct HttpVectorTileSource { /* private fields */ }

A TileSource that fetches and decodes Mapbox Vector Tiles (PBF) over HTTP.

See the module-level documentation for the full pipeline description.

Implementations

impl HttpVectorTileSource

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

Create a new HTTP vector tile source.

The URL template should produce PBF/MVT binary responses, e.g. "https://demotiles.maplibre.org/tiles/{z}/{x}/{y}.pbf".

pub fn with_deferred_decode(self, deferred: bool) -> Self

Enable deferred decoding mode.

When enabled, poll returns TileData::RawVector payloads carrying the raw PBF bytes instead of performing the MVT decode inline. The caller is responsible for submitting the decode work to a background thread and promoting the tile cache entry once complete.

pub fn deferred_decode(&self) -> bool

Whether deferred decoding is enabled.

pub fn with_tilejson(self, tilejson: TileJson) -> Self

Attach TileJSON metadata to configure source zoom range and bounds filtering.

pub fn with_decode_options(self, options: MvtDecodeOptions) -> Self

Set MVT decode options (e.g. layer filter).

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

Add a default header sent with every tile request.

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

Expand the URL template for a given tile ID.

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.

pub fn tilejson(&self) -> Option<&TileJson>

Reference to the attached TileJSON metadata, if any.

Trait Implementations

impl Debug for HttpVectorTileSource

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

Formats the value using the given formatter.

impl TileSource for HttpVectorTileSource

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 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.

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

Optional runtime diagnostics about the source fetch pipeline.