OSM-binary/README

60 lines
1.1 KiB
Plaintext

OSMPBF
======
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 http://wiki.openstreetmap.org/wiki/PBF_Format .
Java Version
============
To build the osmpbf.jar file run:
ant
For a Java usage example, see src.java/crosby/binary/test/ReadFileExample.java
C Version
=========
To compile:
cd src
make
To install:
cd src
make install
There is a tool named osmpbf-outline that shows a debug output of the contents
of a PBF file. To compile it:
cd tools
make
Using the C Library
===================
To include in your program use:
#include <osmpbf/osmpbf.h>
and link with:
-pthread -lz -lprotobuf-lite -losmpbf
Debian/Ubuntu Packages
======================
To build the Debian/Ubuntu packages:
debuild -I -us -uc
To install the Debian/Ubuntu packages:
sudo dpkg --install ../libosmpbf-dev_*.deb
sudo dpkg --install ../libosmpbf-java_*.deb
sudo dpkg --install ../osmpbf-bin_*.deb