The Map View

The map view is the central view of the application. It can be used to view the current gps position, several maps and datasets and can be used to navigate.


The map view.

The map engine comes from the mapsforge project.

The supported datasets section lists and describes all supported map types. Just to cite a few, one can view:

  • OpenStreetMap maps both when online (downloading new tiles) and offline (visualizing those that were cached during online mode)
  • mbtiles databases
  • local and remote TMS tiles
  • mapsforge vector files

Map view tools

The map view has a set of tools that can be exploited to interact with the map.

When first launched, the tools are already visible on the map. To have a cleaner mapview, the user can long-tap on the upper right menu button to toggle the visibility of the tools.


The map view with disabled tools.

Available tools are:

  • Left screen side
    • add note (the same that is accessed from the dashboard)
    • list all notes
    • add bookmark
    • list all bookmarks
    • activate the measure tool
  • Right screen side
    • the context menu button
    • the zoom in and out buttons
  • Lower center
    • battery status
    • center screen on GPS position and GPS status button
    • editing tools

The map view with all map tools visible.

Map navigation

The navigation of the map is probably the most basic and important part.

  • pan: panning of the map, i.e. moving the map around is simply done by dragging the map with a finger. While panning, the current longitude and latitude of the map center are displayed.
  • zoom: zoom in and out can be done in different ways. There are the zoom in/out buttons at the lower right part of the map. It is also possible to zoom in by double-tapping on the map. Zoom in and out can also be achived through pinch-zoom gestures.
  • center on gps: through the lower center button it is possible to center the map on the gps position. The button also shows the status of the GPS the same way as the icon on the main view’s action bar.

Add Notes


The view from which notes are taken.

The add notes button opens the same notes view as the button on the dashboard. There is only once difference. Since notes can be added both in the gps position and in the middle of the map, to open the add note view from the dashboard, the GPS is required to have a fix.

Instead from the map view the user can open the add note view even without GPS signal, in which case he will be allowed to insert notes only in the map center position.

For further information about taking notes, visit the notes section.

The Notes List

The notes list shows all the available notes, both text and image notes.


The notes list view.

In the upper part there is a textbox that helps to filter out a particular note based on its name.


Notes can be filtered by text.

At the right side of the list 2 icon are available. The left one positions the map on the selected note’s position. The rigth one opens a menu:


The note menu.

From the note menu the user is able to:

  • share the note through social networks
  • delete the note
  • use the current note as a filter

Example of using a note as filter for the list.

  • access the submenu related to all notes

The submenu that considers all notes.

From the all-notes submenu the user can:

  • select all notes
  • invert the current selection
  • delete the selected notes

Add Bookmark

Bookmarks are in a layer on their own, that contains saved settings of the current map view. When a bookmark is added, the user is prompted to insert a name for the bookmark or leave the generated name based on the current time and date.


The add bookmark dialog.

When a bookmark is added , a small star is added on the map in the center of the screen.


The bookmark star in the map.

Also the map bounds and zoom are saved. That way one can return to the scenario that the bookmark represents in any moment.

It is possible to tap on the bookmark to read its label.


A tapped bookmark.

The Bookmarks List

The bookmarks list shows all the saved bookmarks.

In the upper part there is a textbox that helps to filter out a particular bookmark based on its name.

The user has 4 options, as the icons on each bookmark entry shows:

  • go to the bookmark location
  • add a proximity alert. In that case a dialog opens and asks for a radius in meters to define the proximity area. Once the gps enters that area, the user will be notified
  • rename the bookmark
  • delete the bookmark

The list of bookmarks.

Measure tool

Activating the measure tool puts the app in measure mode. This mode disables the ability to pan the map while enabling the possibility to draw a line on the map and measure the line drawn.

The approximate (the distance is calculated without considering elevation deltas and with the coordinate picking precision of a finger on a screen) distance is shown in the upper part of the map view.

When active, the measure tool has a red colored icon, when inactive the icon is green instead.


An example of qualitative measurement on the map.

Gps log analysis tool

Apart of charting the log it is possible to analyze the various positions of a gps log. The tool to do so is hidden behind the editing tools button.

If no editing layer is enabled, only two tools appear in the editing tools bar. The lower one is the one that can be used to analize the logs:


Once enabled, one can simply touch the screen near a gps log and information about the nearest log point will be shown. Also the color of the text will be the one of the currently queried log: