osmdb

osmdb imports OpenStreetMap PBF files into a local database and provides fast, read-only access from a CLI, Rust, or Python.

Import a PBF once, then query locations, tagged nodes, ways, and relations by their OSM IDs. Node coordinates are stored in a memory-mapped file for O(1) lookups; the remaining entities are stored in RocksDB.

CLI

The CLI requires Rust 1.85 or newer, a C/C++ build toolchain, and libclang.

cargo install osmdb
osmdb import --pbf world.osm.pbf --output ./world-db

The output directory must be new. Once the import completes, look up one or more IDs:

osmdb lookup --db ./world-db location 240109189
osmdb lookup --db ./world-db node 123456789
osmdb lookup --db ./world-db way 12345678 87654321
osmdb lookup --db ./world-db relation 123456

See CLI usage for prerequisites, aliases, and command details.

Rust

[dependencies]
osmdb = "0.1.0"

use osmdb::DatabaseReader;

let reader = DatabaseReader::open("world-db")?;

let location = reader.get_location(240109189)?;
let node = reader.get_node(123456789)?;
let way = reader.get_way(12345678)?;
let relation = reader.get_relation(123456)?;

Each lookup returns Ok(Some(entity)) when the ID exists and Ok(None) when it does not. See the Rust guide for geometry and iteration.

Python

The typed Python package requires CPython 3.10 or newer and reads databases created by the CLI.

pip install osmdb

from osmdb import Database

with Database("world-db") as db:
    location = db.get_location(240109189)
    way = db.get_way(12345678)

    if way is not None:
        coordinates = db.get_way_geometry(way)

See the Python guide for typed entities, iterators, and source builds.

Documentation

• CLI usage
• Rust API
• Python API
• Storage format
• Development

Licensed under the Apache License 2.0.