Getting started - devemux86/cruiser GitHub Wiki

When Cruiser starts up for the first time, an online map will attempt to load. You'll be asked if you wish to allow Cruiser to access your current location (select "Yes") and the map will zoom into that place, identified with a small colored circle.

The app's main UI in general looks as follows:

  1. Indicator of your current location
  2. Compass rose
  3. Search button (for the integrated offline search)
  4. Navigation button (to start navigation, simulation of a route or follow mode)
  5. Main menu button
  6. Zoom-in button
  7. Zoom-out button
  8. GPS/location button (tapping it centers the map at your current location)
  9. Current map zoom

From here, you have a variety of options:

  • Explore the various menus, options and settings to learn the power of Cruiser
  • Download an offline map, plus routing and POI data
  • Import a list of favorites/waypoints (e.g. GPX file), aka My collection
  • Customize the look of Cruiser
  • And finally go for a ride, and record it as a GPX "track" for later analysis

Most of the way Cruiser looks can be tailored exactly as you wish. If you prefer large "glove-friendly" buttons, that's possible. The information panels can be enabled and positioned as required, incl. their color. The map themes (several are included) offer differently colored road styles, including an option for a "dark" UI/theme for night-time riding. You can even load/edit your own map theme if you like.

Starting a route is as simple as moving the map to where you wish to go, long-press the desired destination on the map (a crosshair target icon allows you to position the point accurately) and set the "End" point. However the exact position is not critical for road routes as the "BRouter" routing engine (if used) will route you via the nearest road.

GPX is a common format for route planning and sharing - these can be loaded as a simple "overlay" (i.e. "follow the line") or as a navigation route. Route enhancements such as Shaping-Points (SPs) and Via-Points (VPs) are also natively handled - more on these over on the Route planning guide. A GPX file from Garmin BaseCamp can be loaded with native support for Shaping-Points and Via-Points (known in Garmin as "Waypoints").