branches-cc / OSM-binary

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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:
  make -C src

To install:
  make -C src install

There is a tool named osmpbf-outline that shows a debug output of the contents
of a PBF file. To compile it:
  make -C tools


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

To clean up after:
  debclean

About

License:GNU Lesser General Public License v3.0


Languages

Language:Java 78.8%Language:Protocol Buffer 16.1%Language:CMake 1.9%Language:Makefile 1.8%Language:C++ 1.1%Language:Shell 0.2%