Osmpbf is a Java/C library to read and write OpenStreetMap PBF files. PBF (Protocol buffer Binary Format) is a binary file format for OpenStreetMap data that uses Google Protocol Buffers as low-level storage.
For more information see https://wiki.openstreetmap.org/wiki/PBF_Format .
Note that this is a low-level library that does only part of the encoding/decoding needed for actually writing/reading an OSM PBF file. For something more complete see libosmium.
We publish the Java library to Maven Central:
org.openstreetmap.pbf osmpbf 1.5.0
To build the Java library run:
If you can not use Maven for some reason you can use the Ant instead:
This will build
osmpbf.jarin the main directory.
This build is also used for Debian packaging.
(Earlier versions used Makefiles for building. Please switch to the CMake-based build, the Makefiles are deprecated and will be removed in a future version.)
mkdir build && cd build cmake .. make
There is a tool named osmpbf-outline that shows a debug output of the contents of a PBF file. To run it:
To include in your program use:
and link with:
-pthread -lz -lprotobuf -losmpbf
The .proto definition files and osmpbf.h are licensed under the MIT license. The other source code is licensed under the LGPL v3+.