OSM Scout Server

Your rating: None Average: 5 (69 votes)

OSM Scout Server is a native offline maps provider. This server can be used as a drop-in replacement for online map services providing map tiles, search, and routing. As a result, together with the map client, a full offline solution is available for map search and navigation (car, bicycle, and walking).

The server can be used to provide:

  • map tiles for other applications;
  • search for locations and free text search;
  • search for POIs next to a reference;
  • calculate the route between two or more locations.

To use the server, you have to start it and configure the client to access it. Poor Maps and modRana have support for the server already with no additional configuration needed.

NB! Versions >=1.16.1 are using compiler included in SFOS 3.3.0.x and are not compatible with the earlier SFOS versions

NB! For SFOS <=3.0.2.x users - do not upgrade here to versions >=1.14.3. Use OBS instead: http://repo.merproject.org/obs/home:/rinigus:/maps/sailfish_3.0.2.8_armv...


Specific update instructions:

1.15.0 Valhalla database format has been updated. Please update maps after installation.

1.14.3 I suggest to uninstall old version of the server, check if anything stayed in /usr/share/harbour-osmscout-server and if that folder is there and/or not empty, remove it using devel-su. After that, install a new version (1.14.3 and up).

NB! When Mapbox GL schema is changed (as for 1.4.0), please remove Mapbox GL application caches.

NB! When a new backend is added, such as with the release of 0.9.0 and 0.10.0, please ensure that you have subscription information updated. For that, in Map Manager, click on "Check for updates", decline updates, and unsubscribe/subscribe each territory that you have subscribed. After that, proceed with the downloads. This is not needed if you don't want to use the added backend(s).

For detailed up-to-date description, please see https://github.com/rinigus/osmscout-server/blob/master/README.md

License: GPL
Source code: https://github.com/rinigus/osmscout-server

User's guide: https://rinigus.github.io/osmscout-server

Official TMO thread: http://talk.maemo.org/showthread.php?t=97823

Donations: https://rinigus.github.io/donate

Screenshots show the running server and, as an example client application, Poor Maps accessing the map tiles and calculated route prior to navigation.

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.



rinigus's picture

That's not very simple. One way would be to make a single import, but it would take large amount of time. Alternative is to have "batch" download, but the server doesn't exactly support it yet. Second alternative would be to generate countries_requested.json file and use it for subscription of the maps. This would allow to enter all European countries as the subscribed ones and use OSM Scout Server to download them.

Right now, I don't think I have time for it. If you would like to do that and know how to program in something that readw/writes JSON, you could try to make a hack for yourself :)

DrYak's picture

Second alternative would be to generate countries_requested.json file and use it for subscription of the maps.


If you would like to do that and know how to program in something that readw/writes JSON, you could try to make a hack for yourself :)

I'm fluent in Perl (in addition to other stuff like C/C++) so cobbling together something like this shouldn't be difficult.

The only thing that bothers me is that currently OSM Scout has only one active map at one time, so this wouldn't allow me to just select "Europe" and be done with it.

rinigus's picture

It has a single active map for libosmscout backend only. For Mapnik, Geocoder-NLP, and Valhalla, all maps are active. This is the default profile and you should be nicely covered.

The selected map on main GUI in the case of default profile (Mapnik, Geocoder-NLP, and Valhalla) is used only by the geocoder for the first preference of the search. Namely, when you search for something you would get hits from that country first (if they are as good as in the other countries).

DrYak's picture

For Mapnik, Geocoder-NLP, and Valhalla, all maps are active.

Then this is definitely interesting for me !

rinigus's picture

That's one of the main reasons why the Default profile enables these backends.

cybershaman's picture

rinigus: thank you for all your great work on this app, it has made my life easier numerous times when abroad.
Is there a technical reason why you opt to having the map server run in foreground (cover) mode only compared to letting it run in background (possibly on SFOS bootup) also?

rinigus's picture

You are welcome! There are few reasons behind such design:

  • Jolla Store does not accept daemons. So, if I want to distribute in the both places, versions would differ and the code will have to be properly #ifdef'd
  • If I make it as a daemon, I would have to communicate changes in settings, maps, and so on. In one application its just a bit easier.

Its possible that I will add daemon mode, but that's not priority yet.

DrYak's picture

I second the request for daemon mode.

rinigus's picture

I added the issue https://github.com/rinigus/osmscout-server/issues/176 . However, note that its lower priority right now. I would like to work on other aspects of the navigation first.

olf's picture

[Daemon or not] For the apps "Situations" and "Find my Jolla" (both in Jolla Store), the solution was to create a separate autostarter for each (both available in Warehouse). Technically, this is not elegant, but that approach works well and avoids conflicting with Jolla's Store guidelines.

Apart from this (i.e. separately), I believe a way to hide the UI on startup of OSM Scout Server would be useful.
Just a spontaneous idea: OSM Scout Server could e.g. generate a notification in the SFOS eventsview when starting (already does that), with which (by tapping on it) its GUI is started (in order to access the GUI, when OSM Scout Server was started without it).

rinigus's picture

@olf, sorry, I forgot to reply to you. I have added your suggestions to github issue to keep all data in the same place. Will look into it when I have finished few other things

olf's picture

Absolutely fine, I have already seen that on github. :)

Thanks for planning to take a look at this; making an automatic start-up without GUI possible would be really nice, and hopefully I managed to point out an easier way to achieve that.

Bramba's picture

Hello rinigus,

thank you very much for your great work and your useful app! :-)

There is one question from my side: If I use Poor Maps or Sailfish Maps in (classic) online-mode, I get the maps displayed in my origin- or in english language (what is great!). However, if I switch on OSM Scout Server and use Poor Maps in offline-mode, I get the map displayed in the language of the country itself. That means, for example in China, I can only see those non-understandable foreign characters instead of city- or streetnames in English language.

When navigating around Asia, it feels very difficult to learn all those foreign characters before switching on the engine... :-)

Is there any option available to select the provided language for foreign countries?

With best regards and thank you!

rinigus's picture
ade's picture

Is there a manual download alternative left? The map download keeps on throwing timeouts and the postal part as a separate download keeps on getting killed by the OOM-killer (mem usage gets around 50%). This postal download is "just" 705MB.

rinigus's picture

Hi! The manual downloads are not available anymore (or more specifically, at present). See TMO thread for details. But let's try to figure out what's going on with your installation and see how I can fix it.

Do I understand correctly that the server gets killed while downloading only and not doing anything?

Either its a bug in my code or there is something that I did not anticipate in your setup. One possibility for large RAM usage could be that your download speed exceeds write speed on storage or its processing by bunzip2. Is this possible? I presume that then some internal buffers could get full and get OOM-killer up. It might also initiate some timeout stops since network download is not bringing any bytes in (waiting for writing).

To test whether timeouts are causing some trouble, try to use 0.7.0 version. That version has a more straightforward download implementation. It wouldn't save you against some other issues, but may help here.

Would you mind to tell which hardware do you use it on and where do you write the maps (internal or external storage)?

Yes postal download is big, but you don't have to use it. It "just" allows you to use a new geocoder :).

Please do report back and tell how is it going. You could use TMO/github/or here. I would like to fix this issue and ensure that everything works as it should.

ziellos's picture

I can confirm the described behaviour. After switching to geocoder-nlp, the download of "Adressanalyse Sprachunterstützung" always stops when < 10 MB of data are remaining (message is "Fehler beim Herunterladen [path]/postal/global/language_classifier/language_classifier.dat" - Timeout).

And your assumption about memory usage is correct. If download is faster than unzipping and writing, the buffer fills up to several hundred MBs (which is not a problem on my Aqua Fish). Doing the same on Jolla 1 with limited RAM may cause the process being killed.

But apart from that issue, your app is simply stunning. I don't know any other app in Sailfish-land of comparable complexity which is that easy to setup and use. The combination of Poor Maps and OSMScout Server may easily outperform Here Maps (Android). Thanks a lot for your work!!!

rinigus's picture

This bug has been fixed, as from yesterday's morning. Fix description: https://github.com/rinigus/osmscout-server/issues/89 . I am preparing for a new release and will few hours for translations before packaging and releasing new version later today. Right now the test version with the fixed bug is distributed as explained at http://talk.maemo.org/showpost.php?p=1525204&postcount=131

Thank you very much for your warm words, its great to know that the work is appreciated!

ziellos's picture

The download issue is now solved. Again, many thanks!

rinigus's picture


ade's picture

I will create a github issue then. Nice to see your drive to fix issues.

mase's picture

Can it provide multiple maps (one per country), or only one a time?

rinigus's picture

Unfortunately, not yet. I have opened issues in github to address that, but there are few other things that I have to fix first. The situation is somewhat more difficult from 0.6.x releases and my priority is to simplify that part with the next release.

The map that you select in general settings, is a map for libosmscout. This map you can either download using OSM Scout application by Karry or make yourself with the importer. If you make it yourself, you can easily generate a map covering several countries. See links at https://github.com/rinigus/osmscout-server#maps

For the new geocoder part, few other databases are needed. I think its impractical to generate libpostal datasets (you need big server with lots of data for it). Those you have to download from links provided at TMO thread. The geocoder database is easier to make, but not trivial (you would need linux PC, installed libpostal, libosmscout, and run geocoder-nlp/importer). That's why I also generate them and distribute together with libpostal database. These databases are made usually one per country. For some countries they are relatively big, but the search speed should be OK in the latest version.

monkeyisland's picture

hi is german language for routing possible?

rinigus's picture

Sure! Its just that the routing instructions would have to be translated. So far, we have translations for Spanish, Swedish, and Czech. If you wish, you could translate it as well and submit the changes via github project page.

naalaa's picture

Hallo rinigus, i installed osm scout server in the latest version on Jolla 1, i downloaded a map from you (germany) and i use poormaps and modrana as clients. Everything works without problems. Very good work. So I want to spend some money for the further work. But I did not find any way to send some money. Maybe you integrate a Button here e.g. pay with paypal or something like this.

rinigus's picture

Thank you very much for your kind words! I am doing it as a hobby and its OK as it is. Its possible that we would need to start taking donations to cover expenses with distribution of the maps for libosmscout or for accessing the other servers via Poor Maps or modRana. Then the situation would possibly change.

As for now - enjoy the server and the clients :)

Reposser's picture

Doesn't install:

Sailfish screenshot with error message

I'm just a user. Unfortunately, I don't have the time and the knowledge to fiddle around with workarounds. It would need to work out of the box.

rinigus's picture

It seems that sometimes Jolla repos get messed up. You might need to refresh the repos. See posts on http://talk.maemo.org/showthread.php?t=97823&page=2

Note that you would have to convert maps as well. A first shot on simpler importer is given in the last post of that thread in TMO. But its not all point and click and requires Linux PC.

makinit's picture

It takes some effort to import the OSM data, but after that it works seamlessly with Poor Maps.