Skip to content

ratrun/biketourplanner

 
 

Repository files navigation

BikeTourPlanner

BikeTourPlanner is an open source desktop application for offline planning of bicycle tours based on the GraphHopper routing engine. It allows the user to generate routing data from OpenStreetMap(OSM) data on demand.

BikeTourPlanner is a nwjs application. It uses offline maps which are provided by OpenMapTiles and displayed using Leaflet and mapbox-gl-js. BikeTourPlanner comes with an integrated local vector tile map server which uses nodejs. It requires an installed Java 8 runtime.

The currently supported platforms are:

  • Linux 64-bit
  • Microsoft Windows 64-bit / 32 bit should work, but is not tested

Implementation of support for Mac OS X 64-bit should be possible with few changes.

The look and feel is similar to GraphHopper Maps as most parts are identical. Here is a screen-shot of the main window:

BikeTourPlanner

User documentation is located here.

Developer information

The BikeTourPlanner nwjs application root is located under in the directory web/src/main/webapp. The GraphHopper graphhopper-web-x.y-SNAPSHOT-with-dep.jar file checked in under web/src/main/webapp/graphhopper is the result of the Graphhopper Web NetBeans project. This file may be built built from the contained modified GraphHopper source files and checked in to git under web\src\main\webapp\graphhopper (web\src\main\webapp\graphhopper\graphhopper-web-x.y-SNAPSHOT-with-dep.jar). The documentation for the graphopper build process is located under docs\core\quickstart-from-source.md. The vector tile server located at web\src\main\webapp\ratrun-mbtiles-server is a git submodul. Development requires installed nodejs version 0.18.6.

These are the installation steps for Linux:

npm install -g nw@0.21.3-sdk 
git clone --recursive https://github.com/ratrun/biketourplanner
cd biketourplanner/web/src/main/webapp
cd web
npm install
cd src/main/webapp
npm install
cd ratrun-mbtiles-server/
npm install 

Verify that the tile server works by starting ../nodejs server.js Here you should see the following output:

Serving files from /home/ratrun/biketourplanner/web/src/main/webapp/data/mbtiles
Listening on port: 3000
Serving following areas:
bicyclenodes
bicycleroutes
liechtenstein 

Press CTRL C and start the application by

cd ..
nw .

You should see the main window and popup notification windows about the start of the tile the server and graph creation. On Windows you probably will get notifications from the firewall. After a litte while the map of Liechtenstein should become visible.

  • To make that js source code modifcations become active automatically, run npm run watch from the web directory in a separate console

Bugs

Report bugs on https://github.com/ratrun/biketourplanner. If possible attach relevant log information. Log information can be created by starting the application via: nw --enable-logging=stderr 1>&2 2>logfile.txt

About

A nwjs application for offline planning of bicycle tours. BikeTourPlanner is OpenSource.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 55.9%
  • Java 41.7%
  • CSS 1.2%
  • Other 1.2%