https://github.com/osmcode/libosmium
Fast and flexible C++ library for working with OpenStreetMap data.
https://github.com/osmcode/libosmium
c-plus-plus openstreetmap
Last synced: about 2 months ago
JSON representation
Fast and flexible C++ library for working with OpenStreetMap data.
- Host: GitHub
- URL: https://github.com/osmcode/libosmium
- Owner: osmcode
- License: bsl-1.0
- Created: 2013-07-29T06:47:29.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2025-03-22T07:53:42.000Z (4 months ago)
- Last Synced: 2025-04-14T03:03:23.813Z (3 months ago)
- Topics: c-plus-plus, openstreetmap
- Language: C++
- Homepage: https://osmcode.org/libosmium/
- Size: 8.54 MB
- Stars: 487
- Watchers: 21
- Forks: 118
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Libosmium
https://osmcode.org/libosmium
A fast and flexible C++ library for working with OpenStreetMap data.
Libosmium works on Linux, macOS and Windows.
[](https://github.com/osmcode/libosmium/actions)
[](https://repology.org/metapackage/libosmium)
Please see the [Libosmium manual](https://osmcode.org/libosmium/manual.html)
for more details than this README can provide.
## Prerequisites
You need a C++14 compiler and standard C++ library.
Different parts of Libosmium (and the applications built on top of it) need
different libraries. You DO NOT NEED to install all of them, just install those
you need for your programs.
For details see the [list of
dependencies](https://osmcode.org/libosmium/manual.html#dependencies) in the
manual.
The following external (header-only) libraries are included in the libosmium
repository:
* [gdalcpp](https://github.com/joto/gdalcpp)
Note that [protozero](https://github.com/mapbox/protozero) was included in
earlier versions of libosmium, but isn't any more.
## Directories
* benchmarks: Some benchmarks checking different parts of Libosmium.
* cmake: CMake configuration scripts.
* doc: Config for API reference documentation.
* examples: Osmium example applications.
* include: C/C++ include files. All of Libosmium is in those header files
which are needed for building Osmium applications.
* test: Tests (see below).
## Building
Osmium is a header-only library, so there is nothing to build for the
library itself.
But there are some tests and examples that can be build. Libosmium uses
cmake:
mkdir build
cd build
cmake ..
make
This will build the examples and tests. Call `ctest` to run the tests.
For more details see the
[Building Libosmium](https://osmcode.org/libosmium/manual.html#building-libosmium)
chapter in the manual.
## Testing
To download the `osm-testdata` submodule call:
```
git submodule update --init
```
This will enable additional tests.
See the
[Libosmium Manual](https://osmcode.org/libosmium/manual.html#running-tests)
for instructions.
## License
Libosmium is available under the Boost Software License. See LICENSE.
## Authors
Libosmium was mainly written and is maintained by Jochen Topf
([email protected]). See the git commit log for other authors.