Skip to main content

Crate mvt

Crate mvt 

Source
Expand description

A library for encoding mapbox vector tiles.

A tile is composed of one or more layers. Each layer can have any number of features, which contain the geometry to be rendered. They can also have metadata tags, which are key/value pairs.

§Example

use mvt::{Error, GeomEncoder, GeomType, Tile};
use pointy::Transform;

fn main() -> Result<(), Error> {
    let mut tile = Tile::new(4096);
    let layer = tile.create_layer("First Layer");
    // NOTE: normally, the `Transform` would come from
    //       `squarepeg::MapGrid::transform_peg`
    let b = GeomEncoder::new(GeomType::Linestring)
        .point(0.0, 0.0)?
        .point(1024.0, 0.0)?
        .point(1024.0, 2048.0)?
        .point(2048.0, 2048.0)?
        .point(2048.0, 4096.0)?
        .encode()?;
    let mut feature = layer.into_feature(b);
    feature.set_id(1);
    feature.add_tag_string("key", "value");
    let layer = feature.into_layer();
    tile.add_layer(layer)?;
    let data = tile.to_bytes()?;
    println!("encoded {} bytes: {:?}", data.len(), data);
    Ok(())
}

Structs§

Feature
A Feature contains map geometry with related metadata.
GeomData
Validated geometry data for Features.
GeomEncoder
Encoder for Feature geometry.
Layer
A layer is a set of related features in a tile.
Tile
A tile represents a rectangular region of a map.

Enums§

Error
MVT Error types
GeomType
Geometry types for Features.