OSM Scout server can be used as a drop-in replacement for online map services providing map tiles, search, and routing. As a result, an offline operation is possible if the device has a server and map client programs installed and running.
Among other services, the server can be used to provide:
User's guide is available at https://rinigus.github.io/osmscout-server .
The server supports:
The server is written using Qt. The server consists of a daemon and separate GUI application for Sailfish, Kirigami, Ubuntu Touch, or a QtQuick application. Installation instructions are given in INSTALL.
Please use Github issues to address specific problems and development requests. General discussion is expected either through corresponding issues, Matrix channel, or TMO thread. Please note that users from all platforms are welcome at TMO, not only current Sailfish OS users.
Starting from version 0.7, the server uses maps distributed via online distribution network. It is expected that the users would download, update, and, when needed, remove maps via server's GUI/CLI. This distribution model allows users to specify which components are required (libosmscout, geocoder-nlp, for example) and download only the required components.
If tinkering is required, it is still possible to import the maps manually. However, in this case, the user is expected to incorporate the manually imported maps into configuration JSON file describing that map and use specific developer options.
Maps are hosted by Natural Language Processing Centre (https://nlp.fi.muni.cz/en/ , Faculty of Informatics, Masaryk University, Brno, Czech Republic) through modRana (http://modrana.org) data repository.
Map data from OpenStreetMap, Open Database License 1.0. Maps are converted to a suitable format from downloaded extracts and/or using polygons as provided by Geofabrik GmbH.
UK postal codes downloaded from https://www.freemaptools.com. These data contain: Ordnance Survey data © Crown copyright and database right 2017; Royal Mail data © Royal Mail copyright and database right 2017; National Statistics data © Crown copyright and database right 2017.
Configuration settings are in ~/.config/osmscout-server/osmscout-server.conf and this file is initialized on the first start. For Sailfish version, add prefix harbour- to the file and directory name.
In configuration file you can specify server HTTP port and the interface. In addition, map directory with several rendering options are configured. In Sailfish, map rendering options are possible to specify through GUI.
Starting from version 0.3.0, server supports up to 100 connections. The requests are processed in parallel, as much as possible, with the number of parallel threads the same as the number of CPUs. Depending on the used backend, one operation can block other operations due to the blocking of the corresponding database. Exceeding the number of supported connections would lead to dropping the connections exceeding the limit.
Exported API and what to consider while adding support for the server by a map client, see separate README.api.
Custom icons used by the application were contributed by Fellfrosch (from talk.maemo.org).
Up to date contribution of translations are given in the About page of the application for corresponding language.
For translations, please see https://github.com/rinigus/osmscout-server/blob/master/translations/README.md
Please note that libpostal is developed to be used with the fine tuned model covering the World. The country-based models were developed to use libpostal in mobile devices and have not been specifically tuned. Please submit the issues with libpostal performance on country-based models to OSM Scout Server or geocoder-nlp github projects.
GNU Libmicrohttpd: https://www.gnu.org/software/libmicrohttpd
Mapbox GL import scripts: https://github.com/rinigus/mapbox-gl-importer