Struct Feature

pub struct Feature { /* private fields */ }

A Feature contains map geometry with related metadata.

A new Feature can be obtained with Layer.into_feature. After optionally adding an ID and tags, retrieve the Layer with the Feature added by calling Feature.into_layer.

Example

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

let tile = Tile::new(4096);
let layer = tile.create_layer("First Layer");
let geom_data = GeomEncoder::new(GeomType::Point)
    .point(1.0, 2.0)?
    .point(7.0, 6.0)?
    .encode()?;
let feature = layer.into_feature(geom_data);
// ...
// add any tags or ID to the feature
// ...
let layer = feature.into_layer();

Implementations

impl Feature

pub fn into_layer(self) -> Layer

Complete the feature, returning ownership of the layer.

Examples found in repository

examples/simple.rs (line 17)

fn main() -> Result<(), Error> {
    let mut tile = Tile::new(4096);
    let layer = tile.create_layer("First Layer");
    // NOTE: normally, the Transform would come from MapGrid::tile_transform
    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(())
}

pub fn layer(self) -> Layer

Get the layer, abandoning the feature.

pub fn set_id(&mut self, id: u64)

Set the feature ID.

Examples found in repository

examples/simple.rs (line 15)

fn main() -> Result<(), Error> {
    let mut tile = Tile::new(4096);
    let layer = tile.create_layer("First Layer");
    // NOTE: normally, the Transform would come from MapGrid::tile_transform
    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(())
}

pub fn num_tags(&self) -> usize

Get number of tags (count).

pub fn add_tag_string(&mut self, key: &str, val: &str)

Add a tag of string type.

Examples found in repository

examples/simple.rs (line 16)

fn main() -> Result<(), Error> {
    let mut tile = Tile::new(4096);
    let layer = tile.create_layer("First Layer");
    // NOTE: normally, the Transform would come from MapGrid::tile_transform
    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(())
}

pub fn add_tag_double(&mut self, key: &str, val: f64)

Add a tag of double type.

pub fn add_tag_float(&mut self, key: &str, val: f32)

Add a tag of float type.

pub fn add_tag_int(&mut self, key: &str, val: i64)

Add a tag of int type.

pub fn add_tag_uint(&mut self, key: &str, val: u64)

Add a tag of uint type.

pub fn add_tag_sint(&mut self, key: &str, val: i64)

Add a tag of sint type.

pub fn add_tag_bool(&mut self, key: &str, val: bool)

Add a tag of bool type.