https://github.com/framstag/libosmscout
Libosmscout is a C++ library for offline map rendering, routing and location lookup based on OpenStreetMap data
https://github.com/framstag/libosmscout
android c-plus-plus clang gcc geodata geolocation ios library linux macos map offline offline-maps offline-rendering openstreetmap openstreetmap-data osm routing tiles windows
Last synced: about 1 month ago
JSON representation
Libosmscout is a C++ library for offline map rendering, routing and location lookup based on OpenStreetMap data
- Host: GitHub
- URL: https://github.com/framstag/libosmscout
- Owner: Framstag
- License: other
- Created: 2015-08-31T20:20:43.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-02-28T11:54:50.000Z (3 months ago)
- Last Synced: 2025-04-08T12:09:21.865Z (about 1 month ago)
- Topics: android, c-plus-plus, clang, gcc, geodata, geolocation, ios, library, linux, macos, map, offline, offline-maps, offline-rendering, openstreetmap, openstreetmap-data, osm, routing, tiles, windows
- Language: C++
- Homepage:
- Size: 78.9 MB
- Stars: 276
- Watchers: 23
- Forks: 82
- Open Issues: 52
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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. We recommend 64 bit on desktop.
* Requires a compiler that supports C++20.
* 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 r26 or newer (with C++20 support).
# License
The libraries itself are under LGPL. For details see the [LICENSE](/LICENSE) file.
# Homepage
The official homepage is at: http://libosmscout.sourceforge.net/.
# Support
Please subscribe to the [mailing list](https://sourceforge.net/p/libosmscout/mailman/libosmscout-development/)
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](http://libosmscout.sourceforge.net/documentation/).
The documentation in the [OpenStreepMap Wiki](http://wiki.openstreetmap.org/wiki/Libosmscout)
is currently still correct but is not activily maintained by the
libosmscout team.
# Features
You can find a list of features [here](http://libosmscout.sourceforge.net/features/).
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](http://libosmscout.sourceforge.net)
and some other documentation in the [git repository](/Documentation/).
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](https://github.com/Framstag/libosmscout/actions).
Static code analysis on [Sonar cloud](https://sonarcloud.io/dashboard?id=Framstag_libosmscout).
Goal is to check all supported platforms, compilers and build systems to keep project in good condition.
Current build status:
| Operating Systems | Provider | Status |
|-----------------------------|-----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Linux (Ubuntu 22.04) | Github Actions | [](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_ubuntu_22_04.yml) |
| Linux (Ubuntu 24.04) | Github Actions | [](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_ubuntu_24_04.yml) |
| Linux (with sanitizers) | Github Actions | [](https://github.com/Framstag/libosmscout/actions/workflows/sanitize_on_ubuntu_22_04.yml) |
| Android (on Ubuntu 22.04) | Github Actions | [](https://github.com/Framstag/libosmscout/actions/workflows/build_on_ubuntu_22_04_qt_android.yml) |
| iOS | Github Actions | [](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_ios.yml) |
| Mac OS X | Github Actions | [](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_osx.yml) |
| Windows, MSYS/MINGW64 | Github Actions | [](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_msys.yml) |
| Windows, Visual Studio 2019 | Github Actions | [](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_vs2019.yml) |
| Sonar | GitHub Actions| [](https://github.com/Framstag/libosmscout/actions/workflows/sonar.yml) |
| Sonar | SonarCloud | [](https://sonarcloud.io/summary/new_code?id=Framstag_libosmscout) |