This page lists more concrete steps to integrate online routing support. Code is currently available at

Routing providers (done)

Support data download from

Marble Widget Paint Layer (done)

  • A custom paint layer which displays routing points: Start, destination, intermediate points. Waypoints, connected.
    • Paint layer reuses the selection model of the routing instruction list view
    • Source, destination and via points are movable in the map
    • Instructions are shown in the mapping when clicking on the corresponding waypoint
  • Paint layer is included in Marble's model

Route/Search UI (done)

  • Merge UI in MarbleControlBox: Search via runners and routing can be done from the same widget similar to how Google Maps does it
  • Default Search is pretty much the same, but has a "Add destination field" button which adds more search widgets (each representing one position to be included in the route)
  • Search results are shown in the list view. The selected search result is kept track of and taken as the source/destination point.
  • Once all routing points are known (user selected a search result or clicked on the map for both routing source and destination and intermediate points, if any), the "Get Directions" button can be used to fetch routing instructions from the current routing provider
  • Routing results are shown in the same list view as marble runner search results
  • Reverse geocoding via osm nominatim
  • Route instruction localization
  • Route preferences: By car, by bycyle, ... avoid highways, avoid toll roads


  • Refactor marble runners to be plugins
  • Refactor routing providers to be plugins
  • Routing providers and marble runners share a common base

Nice to have

  • Progress indicator for route download
  • Support context menu in MarbleWidget
  • Load routes via File -> Open Map
  • Export routes to .gpx, .kml
  • Support printing routes (map with waypoint layer and instructions)
  • D-Bus interface


Ask the oxygen guys if they can help out with some icons:

  • route-instruction (Intermediate route point with turn instructions)
  • route-select (Action to pick route point in the map)


  • Check which routing providers can be shipped / enabled by default
  • OpenRouteService allows non-commercial usage. Exact definition todo
  • Google Maps cannot be used at all (license terms)
  • CloudMade can possibly not be used (cumbersome pricing model)
  • YourNavigation is currently too limited (server often busy, routing data only for UK? No route instructions atm, only waypoints)

This page was last edited on 26 October 2016, at 05:00. Content is available under Creative Commons License SA 4.0 unless otherwise noted.