poka.sh

Docs

PBF

Generated by scripts/gen-format-pages.py from docs/data/format-metadata/, FILE_FORMATS.csv and docs/formats-master.csv. Do not edit by hand: change the source, then run the script.

OpenStreetMap PBF Preview.

At a glance

Purpose An OpenStreetMap PBF extract: blocks of compressed protobuf with nodes, ways and relations.
Extensions .pbf
Poka parser poka-pbf-osm
Viewer poka-metadata-card-viewer
Depth tier Metadata card (see Depth tiers)
Breadth tier B4 Summary (see Breadth tiers)

How much Poka reads

B4 Summary. The container and metadata are read and summarised (counts, properties, structure), but the main content is not rendered.

Confidence: medium (the reviewer read the code). Basis: Reviewed 2026-10-26: read parsers/poka-pbf-osm/src/main.rs (362 lines) and plugin.json. No unit tests or tests/samples.rs; the corpus has no .pbf and .osm.pbf sample. Covers .pbf and .osm.pbf. The card walks the block stream without decompressing and shows the block counts, OSMData blocks, the declared uncompressed size, and from the OSMHeader the writing program, source, required and optional features, bounding box and replication timestamp and sequence. Judgement: B4: the file's structure and header are decoded, but no map data is.

What Poka does not read

  • Nodes, ways and relations are not decoded or counted (the blocks are not decompressed)
  • Nothing is drawn
  • Other formats that use .pbf (Mapbox vector tiles, generic protobuf) are refused or misread (judgement from the code)

Libraries

Libraries Poka uses or has assessed for this format, with the status, licence and language the registry records.

  • osmpbf (candidate; MIT OR Apache-2.0; Rust; https://github.com/b-r-u/osmpbf) — Rust reader for *.osm.pbf with lazy decoding and optional parallelism; default zlib backend is pure Rust (miniz_oxide).
  • osmpbfreader (candidate; WTFPL; Rust; https://github.com/TeXitoi/osmpbfreader-rs) — Read OpenStreetMap PBF files in rust.; v0.19.1, updated 2025-05-26; matched on lib.rs, not tested

Sources

  • parsers/poka-pbf-osm/src/main.rs
  • parsers/poka-pbf-osm/plugin.json