osmflat 
Flat OpenStreetMap (OSM) data format providing an efficient random data access through memory mapped files.
The data format is described and implemented in flatdata. The schema describes the fundamental OSM data structures: nodes, ways, relations and tags as simple non-nested data structures. The relations between these are expressed through indexes.
Compiler
Besides the library for working with osmflat archives, the crate osmflatc contains an OSM pbf format to osmflat data compiler.
To compile OSM data from pbf to osmflat use:
cargo run --release -- input.osm.pbf output.osm.flatdata
The output is a flatdata which is a directory consisting of several files. The schema is also part of the archive. It is checked every time the archive is opened. This guarantees that the compiler which was used to produce the archive fits to the schema used for reading it. The archive data is not compressed.
Using data
You can use any flatdata supported language for reading an osmflat archive. For reading the data in Rust, we provide the osmflat crate.
First, add this to your Cargo.toml:
[dependencies]
osmflat = "0.1.0"
Now, you can open an osmflat archive as any other flatdata archive and read its data:
use osmflat::{FileResourceStorage, Osm};
fn main() {
let storage = FileResourceStorage::new("path/to/archive.osm.flatdata");
let archive = Osm::open(storage).unwrap();
for node in archive.nodes().iter() {
println!("{:?}", node);
}
}
Examples
Check the osmflat/examples directory. Feel free to add another example, if you have an idea what to do with the amazing OSM data in few lines of code.
The above map was rendered by osmflat/examples/roads2png.rs in ~ 170 loc from the osmflat archive based on the latest Berlin OSM data.
License
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)
The files src/proto/fileformat.proto and src/proto/osmformat.proto are copies from the OSM-binary project and are under the LGPLv3 license.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this document by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
63 Dec 5, 2022
2 Dec 31, 2021
12 Sep 19, 2022
2 Dec 11, 2022
921 Jan 7, 2023
66 Dec 30, 2022
6.8k Jan 4, 2023
11 Feb 18, 2022
23 Oct 18, 2022
13 Nov 5, 2023
3 Feb 22, 2024
4 Jan 25, 2023
13 Jun 14, 2023
2.2k Dec 30, 2022
37 Oct 18, 2022