Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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: 7 days ago
JSON representation

Libosmscout is a C++ library for offline map rendering, routing and location lookup based on OpenStreetMap data

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 | [![Build Status](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_ubuntu_22_04.yml/badge.svg)](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_ubuntu_22_04.yml) |
| Linux (Ubuntu 24.04) | Github Actions | [![Build Status](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_ubuntu_24_04.yml/badge.svg)](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_ubuntu_24_04.yml) |
| Linux (with sanitizers) | Github Actions | [![Build Status](https://github.com/Framstag/libosmscout/actions/workflows/sanitize_on_ubuntu_22_04.yml/badge.svg)](https://github.com/Framstag/libosmscout/actions/workflows/sanitize_on_ubuntu_22_04.yml) |
| Android (on Ubuntu 22.04) | Github Actions | [![Build Status](https://github.com/Framstag/libosmscout/actions/workflows/build_on_ubuntu_22_04_qt_android.yml/badge.svg)](https://github.com/Framstag/libosmscout/actions/workflows/build_on_ubuntu_22_04_qt_android.yml) |
| iOS | Github Actions | [![Build Status](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_ios.yml/badge.svg)](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_ios.yml) |
| Mac OS X | Github Actions | [![Build Status](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_osx.yml/badge.svg)](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_osx.yml) |
| Windows, MSYS/MINGW64 | Github Actions | [![Build Status](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_msys.yml/badge.svg)](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_msys.yml) |
| Windows, Visual Studio 2019 | Github Actions | [![Build Status](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_vs2019.yml/badge.svg)](https://github.com/Framstag/libosmscout/actions/workflows/build_and%20test_on_vs2019.yml) |
| Sonar | GitHub Actions| [![Build Status](https://github.com/Framstag/libosmscout/actions/workflows/sonar.yml/badge.svg)](https://github.com/Framstag/libosmscout/actions/workflows/sonar.yml) |
| Sonar | SonarCloud | [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=Framstag_libosmscout&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=Framstag_libosmscout) |