About
Libosmscout is a C++ library for offline map rendering, routing and location lookup based on OpenStreetMap data.
Supported platforms:
- 32bit or 64 bit platforms in general are supported.
- Requires a compiler that supports C++17.
- Supported build systems are CMake and Meson.
- Linux using recent versions of gcc or clang.
- Mac OS X and iOS using XCode/clang.
- Windows using MinGW-based gcc compiler or Visual Studio 2019.
- Android 7 or newer using NDK 18b or newer (with C++17 support).
License
The libraries itself are under LGPL. For details see the LICENSE file.
Homepage
The official homepage is at: http://libosmscout.sourceforge.net/.
Support
Please subscribe to the mailing list and ask your questions. English is the preferred language but other languages might be supported, too.
You can also get support in the matrix room #libosmscout.matrix.org. While
it is a interactive chat room, an answer still may take some
time, though.
Installation
You can find detailed instruction how to get libraries and applications build and working and other introductory documentation on the homepage.
The documentation in the OpenStreepMap Wiki is currently still correct but is not activily maintained by the libosmscout team.
Features
You can find a list of features here. Note that the features pages are currently not up to date. We are unsure how to best represent all the features of libosmscout.
Documentation
You can find some documentation and tutorials on the homepage and some other documentation in the git repository.
There are a number of demo applications that show how to make use of the various features of the library.
We plan to move all documentation for the repository to the homepage.
Automatic builds
Automatic builds can be found at Github Actions, Appveyor and Wecker. Static code analysis on Sonar cloud. Goal is to check all supported platforms, compilers and build systems to keep project in good condition.
Current build status:
| Operating Systems | Provider | Status |
|---|---|---|
| iOS | Github Actions |  |
| Windows, MSYS/MINGW64 | Github Actions |  |
| Mac OS X | Github Actions |  |
| Linux (Ubuntu 20.04) | Github Actions |  |
| Windows, Visual Studio 2019 | Github Actions |  |
| Android (on Ubuntu 18.04) | Github Actions |  |
| Linux (with sanitizers) | Github Actions |  |
| Windows | Appveyor | |
| Linux | Wercker |