Navigation einrichten

Kartenanzeige und Routing sind zwei unabhängige Features, jeweils offline oder online konfigurierbar. Kombinier das frei nach Bedarf.

Zwei unabhängige Entscheidungen

Offline (lokal) Online (Internet)
Kartenanzeige Lokale .mbtiles-Datei Online-Kachel-Server
Routing Lokales Valhalla + Routing-Karten Remote-Valhalla-Server

Kartenanzeige

Die Karten-Einstellung steuert, welche Kachelquelle für die Darstellung benutzt wird. Ob du navigieren kannst, hängt davon nicht ab – das regelt das Routing (siehe unten).

Zwischen den Modi wechseln: Menü → EinstellungenKarten & NavigationKartentyp

Offline-Kartenkacheln

Die Offline-Anzeige nutzt eine lokale .mbtiles-Datei (eine SQLite-Datenbank mit vorgerenderten Kacheln). Einmal installiert, braucht sie keine Internetverbindung mehr.

Eine Kacheldatei für deine Region besorgst du dir so:

Typische Dateigrößen: Stadt ~2–16 MB, einzelnes Bundesland ~20–140 MB, ganz Deutschland ~680 MB.

Zum Installieren legst du die Kacheldatei entweder in den Ordner maps/ auf dem Wechseldatenträger im Updatemodus (am einfachsten), oder kopierst sie per SSH als /data/maps/map.mbtiles auf das DBC. Der Pfad /data/maps/ ist der interne Pfad auf dem Roller und nur per SSH relevant – im Updatemodus siehst du nur den Ordner maps/ auf dem Wechseldatenträger.

Abdeckung
Vorgefertigte Kachelpakete decken aktuell alle 16 deutschen Bundesländer ab. Für andere Regionen erzeugst du dir Kacheln mit maptool aus einem beliebigen OpenStreetMap-Auszug.

Online-Kartenkacheln

Die Online-Anzeige lädt Kacheln beim Verschieben der Karte von einem Internet-Kachel-Server. Keine lokale Datei nötig, nur eine aktive Internetverbindung. Wird automatisch gewählt, wenn keine lokale Kacheldatei vorliegt und der Kartentyp auf Online steht.

Routing

Das Routing liefert Turn-by-Turn-Navigation. Es ist völlig unabhängig von der gewählten Kartenanzeige. Librescoot nutzt dafür die Valhalla-Engine.

Lokales (Offline-)Routing

Lokales Routing betreibt Valhalla direkt auf dem Dashboard-Rechner des Rollers. Dafür brauchst du Valhalla-Routing-Kacheln – ein anderer Datensatz als die .mbtiles-Datei für die Anzeige. Routing-Kacheln enthalten den Straßengraphen, mit dem Valhalla Routen berechnet.

Routing-Kacheln für deine Region bekommst du aus den Librescoot Valhalla Tiles Releases. .tar-Archive pro Bundesland gibt es für alle 16 deutschen Länder.

Typische Archivgrößen: kleine Stadtstaaten (Bremen, Hamburg, Saarland) ~20–60 MB, die meisten Flächenländer ~100–340 MB, Bayern ~910 MB. Das Updatemodus-Laufwerk ist auf 1 GB begrenzt, größere Anzeige- und Routing-Pakete passen also oft nicht gleichzeitig drauf – siehe Updatemodus-Guide.

Archiv auf den Roller übertragen. Am einfachsten per Updatemodus: *tiles.tar in den Ordner maps/ des Wechseldatenträgers legen, sicher auswerfen, der Roller installiert sie automatisch. Alternativ direkt per SSH als /data/valhalla/tiles.tar auf das DBC kopieren. Auf keinen Fall entpacken – Valhalla liest das Tar direkt über seine tile_extract-Einstellung. Sobald Valhalla läuft und Daten geladen hat, erscheint das Navigations-Menü am Dashboard automatisch.

Zwei verschiedene Pfade, dieselbe Datei
Im Updatemodus siehst du nur den Ordner maps/ auf dem Wechseldatenträger – um den Rest kümmert sich der Roller selbst. /data/valhalla/ ist der Pfad im internen Dateisystem des Rollers und nur per SSH relevant. Versuch nicht, /data/valhalla/ über den Updatemodus anzulegen, das funktioniert nicht.
Abdeckung
Vorgefertigte Routing-Kacheln decken aktuell alle 16 deutschen Bundesländer ab. Für andere Regionen baust du dir Valhalla-Kacheln aus einem OpenStreetMap-PBF-Auszug mit dem Standard-Valhalla-Build-Prozess.

Remote (Online-)Routing

Du kannst Librescoot so konfigurieren, dass es einen Remote-Valhalla-Server nutzt, statt lokal zu routen. Der Routing-Endpunkt steht standardmäßig auf lokal (localhost:8002), lässt sich aber mit lsc ändern:

lsc settings set dashboard.valhalla-url https://your-valhalla-server.example/

Aktuelle Einstellung anzeigen: lsc settings list.

Dateien per USB übertragen (Updatemodus)

Der Updatemodus stellt ein virtuelles Laufwerk auf deinem Rechner bereit (über USB-Mass-Storage). Kartendateien draufkopieren, auswerfen, der Roller übernimmt die Installation automatisch. Details im Updatemodus-Guide.

Kurzversion: Updatemodus über Einstellungen → System → Updatemodus starten aktivieren, USB verbinden, .mbtiles und/oder *tiles.tar in den Ordner maps/ kopieren und sicher auswerfen.

Prüfen, ob alles funktioniert

Nach der Übertragung bestätige kurz, dass die Navigation aktiv ist, bevor du losfährst:

  1. Menü öffnen (doppelt auf die linke Bremse tippen). Wenn Navigation einrichten nicht mehr aufgelistet ist, ist deine Konfiguration komplett
  2. Wenn doch, tippe darauf, um zu sehen, welche Komponente noch fehlt (Routing-Engine, Offline-Anzeigekarten oder beides)
  3. Per SSH auf dem Roller prüfen, ob Valhalla läuft:
    ssh -J root@<mdb-ip> root@192.168.7.2 "systemctl status valhalla"
  4. Routing direkt testen:
    ssh -J root@<mdb-ip> root@192.168.7.2 \
      "curl -s http://localhost:8002/status | python3 -m json.tool"
    Ein gesundes Valhalla antwortet mit {"version": "...", "tileset_last_modified": ...}. Gibt es einen Fehler, hat Valhalla keine Kacheln geladen. Prüf, ob /data/valhalla/tiles.tar existiert.
  5. Bestätigen, dass die Anzeige-Kacheln gefunden werden:
    ssh -J root@<mdb-ip> root@192.168.7.2 "ls -lh /data/maps/"
    Du solltest map.mbtiles sehen.

SSH-Transfer (für Fortgeschrittene)

Mit SSH-Zugang kannst du Dateien auch ohne Updatemodus direkt übertragen. Das DBC (Dashboard Computer, unter 192.168.7.2) ist nur per Jump-Host über das MDB erreichbar:

ssh -J root@<mdb-ip> root@192.168.7.2

Anzeige-Kacheln

  1. .mbtiles-Datei auf das DBC kopieren:
    scp -J root@<mdb-ip> tiles_berlin.mbtiles root@192.168.7.2:/data/maps/map.mbtiles
  2. Auf dem DBC scootui-qt neu starten, damit die neue Datei geladen wird:
    ssh -J root@<mdb-ip> root@192.168.7.2 "systemctl restart scootui-qt"

Valhalla-Routing-Kacheln

Valhalla liest das .tar-Archiv direkt – nicht entpacken. Einfach als /data/valhalla/tiles.tar ablegen.

  1. Auf dem DBC das Zielverzeichnis anlegen:
    ssh -J root@<mdb-ip> root@192.168.7.2 "mkdir -p /data/valhalla"
  2. Archiv direkt an seinen Zielort kopieren:
    scp -J root@<mdb-ip> valhalla_tiles_berlin.tar root@192.168.7.2:/data/valhalla/tiles.tar
  3. Valhalla neu starten:
    ssh -J root@<mdb-ip> root@192.168.7.2 "systemctl restart valhalla"

← Installation USB-Dateiübertragung →