mapsforge-rs

A Rust parser for Mapsforge binary map files. This library provides functionality to read and parse Mapsforge map files (.map), which are commonly used for offline mapping applications.

Features

• Map header parsing
  • Magic bytes validation
  • Version checking
  • Bounding box parsing
• Map tile parsing (Coming soon)
• POI data structure (Coming soon)
• Sub-file structure parsing (Coming soon)

Installation

Add this to your Cargo.toml:

[dependencies]
mapsforge-rs = "0.1.0"

Usage

Reading Map Header

use std::fs::File;
use std::io::BufReader;
use mapsforge_rs::MapHeader;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Open and read the map file
    let file = File::open("path/to/map.map")?;
    let mut reader = BufReader::new(file);
    
    // Parse the header
    let header = MapHeader::read_from_file(&mut reader)?;
    
    // Access header information
    println!("Map bounds: {:?}", header.bounding_box);
    println!("File version: {}", header.file_version);
    println!("Tile size: {}", header.tile_size);
    
    Ok(())
}

Requirements

• Rust 1.56 or higher
• byteorder crate for handling endianness
• No other external dependencies required

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Based on the Mapsforge binary format
• Inspired by the Java implementation in the main Mapsforge project

Development Status

This project is in active development. Current focus is on implementing basic file parsing capabilities.