26 releases (13 stable)

4.6.0 Feb 12, 2025
4.5.0 Dec 9, 2024
4.4.0 Sep 26, 2024
4.2.1 Jun 17, 2024
0.3.0 Mar 20, 2020

#6 in Geospatial

Download history 164/week @ 2024-11-18 185/week @ 2024-11-25 152/week @ 2024-12-02 780/week @ 2024-12-09 239/week @ 2024-12-16 32/week @ 2024-12-23 26/week @ 2024-12-30 212/week @ 2025-01-06 217/week @ 2025-01-13 297/week @ 2025-01-20 327/week @ 2025-01-27 321/week @ 2025-02-03 528/week @ 2025-02-10 552/week @ 2025-02-17 475/week @ 2025-02-24 275/week @ 2025-03-03

1,831 downloads per month
Used in 12 crates (10 directly)

BSD-2-Clause

270KB
5K SLoC

FlatGeobuf for Rust

Rust implementation of FlatGeobuf.

FlatGeobuf is a performant binary encoding for geographic data based on flatbuffers that can hold a collection of Simple Features including circular interpolations as defined by SQL-MM Part 3.

Usage

use flatgeobuf::*;

fn main() {
    let mut filein = BufReader::new(File::open("countries.fgb")?);
    let mut fgb = FgbReader::open(&mut filein)?.select_all()?;
    while let Some(feature) = fgb.next()? {
        println!("{}", feature.property::<String>("name").unwrap());
        println!("{}", feature.to_json()?);
    }
}

With async HTTP client:

use flatgeobuf::*;

async fn process() {
    let mut fgb = HttpFgbReader::open("https://flatgeobuf.org/test/data/countries.fgb")
        .await?
        .select_bbox(8.8, 47.2, 9.5, 55.3)
        .await?;
    while let Some(feature) = fgb.next().await? {
        let props = feature.properties()?;
        println!("{}", props["name"]);
        println!("{}", feature.to_wkt()?);
    }
}

See documentation and tests for more examples.

Run tests and benchmarks

cargo test

cargo criterion

Run fuzzer

cargo install cargo-fuzz

cargo +nightly fuzz run read

Dependencies

~4–18MB
~273K SLoC